Go http.Cookie 怎样读取 Set-Cookie 的 Raw 字段

在 Go 中读取 Set-Cookie 的完整原始行，优先使用 http.ParseSetCookie 或 resp.Cookies()，然后读取返回对象的 Raw 字段。Raw 保存的是解析时传入的整行文本；Cookie.String() 则会根据已经识别的字段重新拼出一行，两者不能混用。

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

Raw 字段从哪里来

http.Cookie 同时承载结构化字段和若干“读取时保留”的字段。Go 官方实现中，ParseSetCookie 先解析名称和值，再创建 Cookie，并把输入行写入 Raw。因此，Raw 的来源不是 HTTP 客户端额外发起的请求，也不是对 Cookie.String() 的再次调用，而是解析入口收到的那一行。

package main

import (
    "fmt"
    "net/http"
)

func main() {
    line := "session=abc123; Path=/; HttpOnly; SameSite=Lax"

    // ParseSetCookie 负责把 Set-Cookie 行拆成结构化字段。
    cookie, err := http.ParseSetCookie(line)
    if err != nil {
        // 语法错误时没有可靠的 Cookie 结果，先保留错误信息。
        panic(err)
    }

    fmt.Println("name:", cookie.Name)
    fmt.Println("value:", cookie.Value)
    // Raw 是解析入口收到的完整原始行。
    fmt.Println("raw:", cookie.Raw)
}

这个例子中，cookie.Raw 会包含 session=abc123; Path=/; HttpOnly; SameSite=Lax 整行，而 Name、Value、Path 和 SameSite 是拆分后的结构化结果。图中的分流表示同一条输入同时产生两种用途不同的数据。

从 http.Response.Cookies 逐个读取 Raw

如果 Cookie 来自 HTTP 响应，可以直接调用 resp.Cookies()。这个方法返回响应中成功解析的 Cookie；拿到切片后读取每个元素的 Raw 即可。响应可能包含多条 Set-Cookie，不要只用 Header.Get 把它当成唯一值。

package main

import (
    "fmt"
    "net/http"
)

func printResponseCookieRaw(resp *http.Response) {
    // Cookies 会解析响应里的 Set-Cookie，并返回成功的 Cookie 对象。
    for index, cookie := range resp.Cookies() {
        // Raw 用于日志或诊断时保留服务端送来的完整输入行。
        fmt.Printf("cookie[%d] name=%q raw=%q\n", index, cookie.Name, cookie.Raw)
    }
}

需要注意的是，resp.Cookies() 面向“拿到可用 Cookie”这个任务。按照标准库的读取路径，单条 Set-Cookie 解析失败时会被跳过；如果你的日志或网关诊断必须知道是哪一行失败，就应直接遍历响应头并调用 ParseSetCookie，自己记录每一行的错误。

严格诊断时遍历 Header.Values

读取原始行并不等于绕过解析。最实用的做法是保留输入行，同时把解析错误与成功结果分开记录。Header.Values("Set-Cookie") 能拿到同名头的多条值；每一条都单独调用解析函数，出现错误时不会影响其他行。

func parseSetCookieLines(header http.Header) ([]*http.Cookie, []error) {
    lines := header.Values("Set-Cookie")
    cookies := make([]*http.Cookie, 0, len(lines))
    errs := make([]error, 0)

    for _, line := range lines {
        // 每条 Set-Cookie 独立解析，避免一条坏数据掩盖其他 Cookie。
        cookie, err := http.ParseSetCookie(line)
        if err != nil {
            // 记录原始行和错误，便于定位服务端输出问题。
            errs = append(errs, fmt.Errorf("parse %q: %w", line, err))
            continue
        }
        cookies = append(cookies, cookie)
    }
    return cookies, errs
}

如果只想输出原始行而不需要结构化字段，也可以直接遍历 header.Values("Set-Cookie")。但只要后续要判断 Cookie 名称、路径或有效期，就应该保留 ParseSetCookie 返回的对象，不要自行用分号切割，因为属性值和引号会让手工分割变得脆弱。

Raw、Unparsed 和 String 不要混用

func showCookieRepresentations(cookie *http.Cookie) {
    // Raw 保留整行，包含解析器可能忽略的空格和属性顺序。
    fmt.Println("raw:", cookie.Raw)
    // Unparsed 只保留未识别的属性片段，不等于完整原文。
    fmt.Println("unparsed:", cookie.Unparsed)
    // String 根据结构化字段重建输出，可能与 Raw 的排版不同。
    fmt.Println("serialized:", cookie.String())
}

手工构造的 Cookie 也说明了这一点：如果直接写 &http.Cookie{Name: "session", Value: "abc"}，它并没有经历 ParseSetCookie，所以 Raw 通常为空；调用 String() 得到的是根据字段生成的新文本，而不是某个服务端原文的回放。

多条 Cookie 和失败行的处理清单

• 需要“尽可能拿到可用 Cookie”时，用 resp.Cookies()，并接受解析失败行被忽略的行为。
• 需要审计每一条 Set-Cookie 时，用 Header.Values("Set-Cookie") 逐条调用 ParseSetCookie，同时记录原始行和错误。
• 需要保存服务端原文时写入 cookie.Raw，不要只保存 cookie.String()。
• 需要转发或标准化输出时，根据结构化字段调用 String()，不要把 Raw 当成永远合法、永远适合直接转发的文本。
• 未知属性可以先看 Unparsed，日期格式问题可以同时查看 RawExpires 和 Expires。

常见问题

为什么我拿到的 Cookie.Raw 是空字符串？

最常见原因是 Cookie 由代码手工构造，或者来自只解析请求头的 ParseCookie。要保留 Set-Cookie 原文，应把服务端的 Set-Cookie 行交给 ParseSetCookie，或从响应调用 Cookies()。

Cookie.String() 能不能替代 Raw？

不能。String() 适合按当前结构化字段生成规范化输出；如果需要完整输入、原始空格、属性顺序或未知属性诊断，应保留 Raw。

resp.Cookies() 为什么比 Header.Values 少一条？

它只返回成功解析的 Cookie。对格式不符合要求的 Set-Cookie，标准库的响应读取路径可能跳过该行；要定位原因，应逐条调用 ParseSetCookie 并保存返回的错误。