Go net/textproto 怎么读取请求头

我第一次用 net/textproto 处理一段邮件式协议数据时，最容易犯的错是把“读取原始文本头”和“访问已经解析好的 HTTP 请求头”当成同一件事。结论先说：如果手里是字节流或 bufio.Reader，用 textproto.NewReader 配合 ReadMIMEHeader；如果已经在 net/http.Handler 里，直接用 r.Header，不要再把它转回文本解析。

ReadMIMEHeader 会读取到空行结束的 Key: Value 头部，重复键保留为多个值，带空格或制表符的续行会并入上一行。生产代码还应给输入加长度上限，并检查返回的 error。

先分清你拿到的是文本还是 Header

net/textproto 的 Reader 面向文本协议，能够读取状态码行、普通行、续行和 MIME 风格头部。它的 MIMEHeader 本质是 map[string][]string：同一个键出现多次，不会被后一次覆盖。

反过来，HTTP 服务端的 http.Request.Header 已经是解析后的键值集合。此时调用 Header.Get 或 Header.Values 就够了。我的判断标准很简单：还在处理连接上的原始字节，用 textproto；已经进入 Handler，就不要重复造一个文本解析层。

ReadMIMEHeader 读取请求头的最小写法

下面构造一段带重复字段和续行的 HTTP 风格头部。末尾的空行很重要，它告诉读取器头部已经结束；没有这个分隔，读取过程可能继续等待更多输入。

package main

import (
    "bufio"
    "fmt"
    "io"
    "net/textproto"
    "strings"
)

func readHeaders(raw string) (textproto.MIMEHeader, error) {
    // 限制原始输入规模，避免无界头部占用过多内存。
    limited := io.LimitReader(strings.NewReader(raw), 32*1024)
    reader := textproto.NewReader(bufio.NewReader(limited))

    // ReadMIMEHeader 读取到空行，并保留同名键的多个值。
    headers, err := reader.ReadMIMEHeader()
    if err != nil {
        return nil, fmt.Errorf("读取请求头: %w", err)
    }
    return headers, nil
}

func main() {
    raw := "Host: api.example.test\\r\\n" +
        "Accept: application/json\\r\\n" +
        "Accept: text/plain\\r\\n" +
        "X-Trace: part-a\\r\\n" +
        "  part-b\\r\\n\\r\\n"

    headers, err := readHeaders(raw)
    if err != nil {
        // 解析失败时不要继续使用不完整的 map。
        panic(err)
    }
    fmt.Println(headers.Get("Host"))
    fmt.Println(headers.Values("Accept"))
    fmt.Println(headers.Get("X-Trace"))
}

这个例子里，Accept 会对应两个值，而 X-Trace 的续行会和第一行拼成一个逻辑值。io.LimitReader 不是协议解析规则，而是调用方给输入设置的资源边界；上限应结合业务协议和代理配置调整。

Get、Values 与直接索引该怎么选

读取请求头时，先问自己“这个字段允许出现几次”。单值语义用 Get 最直观；需要保留多个 Accept、Cookie 或自定义字段时用 Values。官方文档说明，Get 返回第一个值，没有值时返回空字符串；这意味着空字符串和缺失字段不能只靠返回值区分。

ReadMIMEHeader 会把键名按 MIME 规则规范化，首字母和连字符后的字母转为大写，其余转为小写。因此用 h["content-type"] 直接索引时可能取不到保存的 Content-Type；一般优先使用大小写不敏感的 Get 或 Values。

读不到或读不完整时检查四个信号

1. 输入是否有空行。 头部以空行结束，只有一串没有终止分隔的文本并不能保证读取完成。
2. 续行是否真的以空格或制表符开头。 只有这种行会被当成上一字段的延续，不能用任意缩进替代协议规则。
3. 是否误用了 Get。 同名字段被保留了，但 Get 只返回第一个值；需要完整集合时改用 Values。
4. 是否检查 error 和长度上限。 输入截断、格式异常或读取失败都必须停止使用结果；读取器也不应面对无限大小的外部数据。

还有一个实践边界：如果目标是读取真实 HTTP 请求，不建议自己在 TCP 层复刻整套 HTTP 解析。net/http 已经负责请求头解析、协议细节和 Handler 交接；net/textproto 更适合自定义文本协议、测试夹具，或你明确掌握输入边界的协议适配层。

常见问题

ReadMIMEHeader 会只保留最后一个同名字段吗？

不会。它返回 map[string][]string，同名键按输入顺序放进切片；只有调用 Get 时才主动取第一个值。

为什么直接用小写键名取不到值？

读取时键名可能已经被规范化。用 Get 或 Values 访问更稳妥；必须直接索引时，先确认 map 中实际保存的键名。

续行内容会保留换行符吗？

ReadContinuedLine 的语义是移除换行和续行开头的空白，并用一个空格连接逻辑行；ReadMIMEHeader 使用同类规则形成字段值。

在 net/http 中还需要调用 textproto 吗？

通常不需要。Handler 已经拿到 http.Header，直接用它的 Get 或 Values；只有原始数据尚未被 HTTP 层解析时才考虑 textproto.Reader。

参考：Go net/textproto 官方文档；Go net/http Header 官方文档。两者的共同点是键值集合，差别在于前者负责从文本流读取，后者通常已经处在 HTTP 请求处理阶段。