Go net/http 怎样读取重复响应头

我在接入一个会返回多个 Set-Cookie 的接口时，最容易写错的地方不是发请求，而是读取响应头：Header.Get 看起来很顺手，却只会给出第一个值。Go 的 net/http 已经把同名响应头保存成切片，真正需要全部值时，应优先使用 Header.Values。

官方地址：https://pkg.go.dev/net/http#Header.Values

记住一句话：需要保留同名响应头的完整信息就用 Values；业务上只接受一个值才用 Get。不要先把所有值拼成逗号字符串，再假设任何响应头都能按逗号还原。

先弄清 Header 的数据形状

http.Header 的底层形态是 map[string][]string。这意味着同一个键可以对应多个值，调用方不应该把响应头理解成简单的 map[string]string。

比如服务端返回两个同名字段时，客户端更接近下面的关系：

这里有一个实用判断：如果字段天然可以重复，例如多个 Cookie、多个警告信息或多个自定义标签，就先保留切片；如果协议或业务明确规定只看一个值，再在边界处取单值。

用 Header.Values 读取全部值

Values 会返回给定键关联的全部值，键名比较不区分大小写。下面用一个手工构造的响应头演示读取逻辑，代码重点是保留切片，而不是把它压扁成一行文本。

package main

import (
    "fmt"
    "net/http"
)

func main() {
    header := make(http.Header)
    // Add 会追加同名值，适合模拟服务端返回多个响应头。
    header.Add("Set-Cookie", "sid=abc")
    header.Add("Set-Cookie", "theme=dark")

    values := header.Values("set-cookie")
    // Values 保留每个值，逐项处理能避免误把逗号当成统一分隔符。
    for index, value := range values {
        fmt.Printf("%d: %s\\n", index, value)
    }
}

这个示例中，values 的结果是两个字符串，顺序与 Header 中保存的顺序一致。实际处理时可以逐项解析、逐项记录，或者把每一项交给专门的 Cookie 处理逻辑。

只需要一个值时再用 Header.Get

Get 的语义很明确：返回该键关联的第一个值，没有值时返回空字符串。它适合业务只定义了单值含义的场景，例如读取一个自定义版本标识。

func readVersion(header http.Header) (string, bool) {
    // Get 只取第一个值；先明确这是业务选择，而不是完整读取。
    value := header.Get("X-Api-Version")
    if value == "" {
        // 空字符串既可能是缺失，也可能是发送方传了空值，按业务需要继续细分。
        return "", false
    }
    return value, true
}

如果同名字段可能有多个值，直接调用 Get 就会静默丢掉后续值。这个问题往往不会立刻报错，只有当第二个值携带了权限、路由或缓存信息时才暴露，因此最好在代码评审时把选择写得明显。

大小写、缺失值和返回切片要注意什么

第一，Header 键名按规范进行 canonicalization，Values("set-cookie") 和 Values("Set-Cookie") 都能读取标准写法。不要为了大小写再复制一份 map。

第二，缺失键时，Values 得到的是没有元素的切片，Get 得到的是空字符串。若空字符串本身也是合法值，单靠 Get 就无法区分“缺失”和“存在但为空”，这时应使用 Values 检查是否存在元素。

第三，官方文档说明 Values 返回的切片不是副本。读取后如果要长期保存，或要交给会修改切片的代码，先复制一份；只读遍历则不需要额外分配。

func copyHeaderValues(header http.Header, key string) []string {
    source := header.Values(key)
    // 复制切片，避免后续代码持有 Header 内部返回切片的引用。
    copied := make([]string, len(source))
    copy(copied, source)
    return copied
}

按字段语义选择读取方式

尤其不要把多个值一律拼接成 a,b,c。有些头字段允许逗号分隔，有些字段的值本身就可能含逗号，还有些字段在 HTTP 语义上不能简单合并。保留原始多值，等确定字段规则后再解析，通常更稳。

常见问题

Header.Values 找不到键时会返回什么？

它返回没有元素的切片。用 len(values) == 0 判断缺失比把结果转成字符串更可靠。

Header.Get 能读取所有重复响应头吗？

不能。它只返回第一个值；需要完整结果时改用 Values。

为什么不直接访问 Header map？

直接访问可以处理非 canonical 的特殊键，但常规代码优先使用方法更清晰，也能让大小写处理和读取意图集中在 API 语义上。

Values 返回的切片需要复制吗？

只读遍历通常不用；跨越请求处理生命周期保存，或交给会修改切片的代码时，建议复制。

小结

Go 读取重复响应头的关键不在于把字符串拆开，而在于尊重 http.Header 的多值数据结构：完整读取用 Header.Values，明确只取首值才用 Header.Get，需要长期持有结果时再复制切片。这样既不会静默丢字段，也能把协议差异留在正确的解析边界。