Go Cookie 怎样保留原始属性字符串

如果你的 Go 服务需要把收到的 Set-Cookie 原样记录、审计或透传，不要把解析后的字段重新拼成字符串。用 net/http.ParseSetCookie 解析后，原始整行在 Cookie.Raw，Expires 属性的原始文本在 Cookie.RawExpires；业务判断则使用 Path、Domain、MaxAge 等结构化字段。

官方资料：https://pkg.go.dev/net/http#Cookie

先分清 Raw、RawExpires 与结构化字段

这类问题的基线不是“字符串有没有被成功解析”，而是同一条头部经过不同路径后，哪些信息仍然可恢复。假设一条 Set-Cookie 含有名称和值、Expires、Path 以及一个 Go 暂未识别的属性，最少要分别观察原文长度、属性数量和未知属性数量。

Raw 保存的是解析入口收到的整行文本；RawExpires 保存 Expires= 后的原始值，而 Expires 是解析后的 time.Time。因此，前者适合原文审计，后者适合做时间比较。Unparsed 则用于承接无法按已知属性解析的属性值对。

用 ParseSetCookie 同时保存原始文本

在支持 ParseSetCookie 的 Go 版本中，可以把解析动作封装成一个小函数：返回结构化 Cookie，同时把原文副本放入业务对象。这样后续即使只读取字段，也不会丢掉透传所需的原始整行。

package main

import (
    "fmt"
    "net/http"
)

type ReceivedCookie struct {
    Parsed *http.Cookie
    RawLine string
}

func parseAndKeepRaw(line string) (ReceivedCookie, error) {
    // ParseSetCookie 负责语法解析；Cookie.Raw 保存传入的完整 Set-Cookie 行。
    cookie, err := http.ParseSetCookie(line)
    if err != nil {
        return ReceivedCookie{}, fmt.Errorf("解析 Set-Cookie 失败: %w", err)
    }

    // 业务对象额外保存一份原文，避免后续只传递结构化字段时丢失格式信息。
    return ReceivedCookie{Parsed: cookie, RawLine: cookie.Raw}, nil
}

func main() {
    line := "sid=abc123; Expires=Wed, 21 Oct 2015 07:28:00 GMT; Path=/; X-Trace=keep"
    received, err := parseAndKeepRaw(line)
    if err != nil {
        panic(err)
    }

    // Expires 用于时间判断，RawExpires 用于保留日期原文，RawLine 用于原样透传。
    fmt.Println(received.Parsed.Expires.IsZero())
    fmt.Println(received.Parsed.RawExpires)
    fmt.Println(received.RawLine == line)
    fmt.Println(received.Parsed.Unparsed)
}

这里的关键不是复制三份 Cookie，而是明确三类用途：判断用结构化字段，审计用 Raw 或 RawLine，无法识别的属性继续留在 Unparsed。如果原文来自不可信网络输入，记录前还应按业务的隐私规则处理敏感 Cookie 值。

为什么 Cookie.String 不能替代原文

很多实现会在解析后直接调用 cookie.String()，然后把结果当成“原始头部”。这一步得到的是合法的重新序列化结果，而不是原文快照。Go 会根据当前字段重新输出属性；字段被修改、日期被标准化或未知属性未被纳入序列化时，结果就可能不同。

func compareCookieForms(line string) error {
    // 解析后分别保存原文和重新序列化结果，用于排查格式差异。
    cookie, err := http.ParseSetCookie(line)
    if err != nil {
        return err
    }

    raw := cookie.Raw
    serialized := cookie.String()

    // 原文比较用于透传场景；String 只用于生成新的合法 Cookie 头部。
    fmt.Printf("raw length=%d, serialized length=%d\n", len(raw), len(serialized))
    fmt.Printf("same bytes=%t\n", raw == serialized)
    return nil
}

如果任务是向下游转发同一条头部，优先传递 Raw；如果任务是根据当前字段生成新 Cookie，才调用 String。不要通过调整空格、手工补属性顺序或拼接字符串，试图让重新序列化结果“看起来像原文”。

按可复现指标做回归检查

为了让格式差异可定位，可以把检查拆成四个简单指标：原文长度、分号分隔的属性数量、结构化字段是否有值、Unparsed 数量。它们不是线上性能指标，而是针对序列化路径的回归信号。

回归时至少保留一条包含日期、路径和未知属性的固定样例，并记录四个指标的变化。若原文长度或未知属性数量发生变化，先检查是不是误用了 String；若 Expires.IsZero() 为真，再检查日期格式是否能被 Go 解析，不要直接用 RawExpires 做时间比较。

几个容易踩到的边界

• Raw 是读入快照，不是编辑入口。 修改 cookie.Path 后，cookie.Raw 不会自动同步；要生成新头部应重新调用 String。
• RawExpires 不是统一日期格式。 它保留原始日期文本，Expires 才是时间判断使用的字段；解析失败时应把错误当作输入问题处理。
• 请求 Cookie 与响应 Set-Cookie 不同。 ParseCookie 解析请求头的键值列表，而 ParseSetCookie 解析响应侧属性，不能混用来期待同样的字段。
• 不要为了日志把完整 Cookie 值裸记。 原始字符串虽然方便排障，也可能包含会话凭据；落日志前应脱敏或只记录长度、属性名和哈希外的业务允许字段。

常见问题

只想保存 Expires 的原始文本，应该用哪个字段？

使用 RawExpires。它适合展示或差异分析；真正做过期判断时读取 Expires。

修改 Cookie 后还能用 Raw 发送吗？

不建议。Raw 是解析时的原文快照，不会随着结构化字段变化；修改后应根据当前字段重新生成头部，并明确接受格式标准化。

为什么 Unparsed 里有属性，但 String 后看不到？

因为 Unparsed 只是解析器保存的未识别属性集合，不等于 String 必须把它们重新写回。需要完整保留时使用 Raw，需要支持新属性时再按业务规则单独处理。

最终可以记住一句话：Raw 负责“我收到的是什么”，结构化字段负责“它表达了什么”，String 负责“我现在要生成什么”。把三者分开，Cookie 的原文保留和业务判断就不会互相干扰。