Go net/http Request.CookiesNamed 怎样读取同名 Cookie

在 Go 服务端需要读取同名 Cookie 时，直接调用 r.Cookie("sid") 只能得到一个匹配项；应改用 r.CookiesNamed("sid")，它会返回指定名称的全部 Cookie，结果类型是 []*http.Cookie。没有匹配项时返回空切片，适合直接遍历。

官方文档：https://pkg.go.dev/net/http#Request.CookiesNamed

这篇只讨论请求头中的 Cookie 解析，不涉及 CookieJar 的保存策略、跨站属性或浏览器行为。先把“一个值”和“多个同名值”的读取边界分开，排查就不会被返回值形态误导。

先理解 Cookie 数据从请求头到切片的关系

Cookie 的输入来自请求头，Go 再把它解析成 *http.Cookie。Request.Cookies() 返回所有 Cookie，Request.Cookie(name) 面向单个名称，Request.CookiesNamed(name) 则只筛选指定名称但保留多个匹配项。

用 CookiesNamed 读取同名 Cookie

下面的示例人为构造两个同名 sid，用于说明返回值是切片而不是单个指针。真实服务端代码中，直接把处理函数收到的 *http.Request 传入相同逻辑即可。

package main

import (
    "fmt"
    "net/http"
)

func readSameNameCookies() error {
    req, err := http.NewRequest(http.MethodGet, "https://example.com/account", nil)
    if err != nil {
        return err
    }
    // 用两个同名 sid 表示请求头中的多值输入，theme 用来说明筛选只按名称进行。
    req.Header.Set("Cookie", "sid=old; sid=new; theme=dark")

    // CookiesNamed 返回指定名称的全部匹配项，没有匹配项时返回空切片。
    cookies := req.CookiesNamed("sid")
    for _, cookie := range cookies {
        // 每个元素都是独立的 Cookie 对象，业务逻辑应明确是否允许多个值。
        fmt.Printf("%s=%s\\n", cookie.Name, cookie.Value)
    }
    return nil
}

这里不需要先调用 Cookies() 再手动过滤；按名称读取时，CookiesNamed 已经把筛选和解析组合起来。空切片可以安全地交给 for range，不要把它当成错误。

Cookie、Cookies 和 CookiesNamed 怎么选

官方文档明确说明：当多个 Cookie 匹配同一个名称时，Cookie 只返回其中一个；需要完整保留同名项时才使用 CookiesNamed。如果业务只允许一个会话标识，读取多个结果后还要自行定义冲突处理，不应默认把第一个值当成可信值。

服务端排障时的四个检查点

1. 先确认名称完全一致。 Cookie 名称是筛选条件，sid 与 SID 不应按同一个业务字段处理。
2. 区分空切片和错误。 CookiesNamed 没找到值时不返回 error；只有需要单值语义时才检查 Cookie 的错误。
3. 不要把 CookieJar 当成请求内容。 CookiesNamed 读取的是当前 Request 的 Cookie 请求头，不负责查询客户端保存的 Cookie。
4. 明确重复值策略。 如果同名值来自不同路径或代理拼接，业务层应决定拒绝、记录全部值，或采用明确的白名单规则。

常见问题

CookiesNamed 是不是只在服务端可用？ 不是。它是 http.Request 的方法，客户端构造的请求同样可以调用；区别只在于请求头由谁填充。

没有同名 Cookie 时能直接 range 吗？ 可以。空切片可以安全遍历，但如果业务必须存在一个值，就应在遍历前明确检查长度。

什么时候仍然用 Cookie？ 当业务协议明确只接受一个 Cookie，并且缺失时需要通过 error 分支处理时，Cookie 更直接。

记忆这条规则即可：要一个值用 Cookie，要全部值用 Cookies，要某个名称的全部值用 CookiesNamed。同名 Cookie 的业务冲突策略，则留在应用层明确决定。