Go中http.Cookie无法直接解析签名cookie，必须手动从Header提取原始字符串、按分隔符拆分、用base64.RawURLEncoding解码签名段，并用hmac.Equal验签；需规避自动url.QueryUnescape破坏Base64URL、key长度不一致以及时序攻击等风险。
Go 中 http.Cookie 无法直接解析签名 cookie，必须手动拆解
标准库的 http.ParseCookie 只负责按 RFC 6265 解析键值对和属性（如 Path、Expires），对带签名或加密的 cookie（比如 session=abc123.HMACSHA256...）完全无感知。这类 cookie 实际是「值 + 签名」拼接而成，必须先分离再验签。
常见错误是直接对整个 cookie 值调用 url.QueryUnescape 后就尝试 JSON 解析，结果因签名部分含非法字符或 Base64 填充而 panic；或者忽略分隔符（如 . 或 :）导致切片越界。
- 约定分隔符优先用
.（类似 JWT），避免与 cookie 值中可能存在的=或;冲突 - 签名前原始数据建议用 JSON 序列化 +
base64.RawURLEncoding编码，保证 URL 安全且无填充字符 - 务必在验签前检查分段数量：少于 2 段直接拒绝，防止
index out of range
用 hmac 包做签名验证时，key 长度和算法必须严格匹配生成端
Go 的 hmac.New 对 key 长度敏感：若使用 sha256，key 长度超过 32 字节会被自动哈希截断；若不足 32 字节，则直接用作 key——这与 Python 的 hmac.compare_digest 或 Node.js 的 crypto.createHmac 行为不一致，极易导致验签失败。
典型场景是前端用 JS 库生成签名 cookie，后端 Go 验证失败。问题常出在 key 处理逻辑不统一：比如 JS 端用 UTF-8 字符串当 key，Go 端却用 []byte 直接传入未做编码转换。
立即学习“go语言免费学习笔记（深入）”；
- 统一用
[]byte表示密钥，避免字符串隐式转换带来的编码差异 - 验签前用
hmac.Equal比较签名，禁止用==（防止时序攻击） - 推荐固定 key 长度：生成时用
sha256.Sum256哈希原始 key 再截取 32 字节，两端保持一致
http.Request.Cookies() 返回的 cookie 值已自动 urldecode，但签名部分可能被破坏
Go 的 http.Request 在解析请求头时，会自动对 cookie 值执行 url.QueryUnescape。这对普通 cookie 是便利，但对 Base64URL 编码的签名来说很危险：比如 _ 和 - 被转成 ~ 或其他字符，导致 HMAC 计算失败。
实际抓包发现，浏览器发送的 cookie 值里签名段常含 _，但 req.Cookies() 返回的 *http.Cookie.Value 已被错误转义。这不是 bug，而是 url.QueryUnescape 把 Base64URL 当作了传统 query string 处理。
- 绕过自动解码：从
req.Header.Get("Cookie")手动提取原始字符串，再用strings.Split拆分;和= - 对签名段单独用
base64.RawURLEncoding.DecodeString，它明确支持_/-，且不处理填充 - 不要依赖
http.Cookie.String()重构 cookie 值，它会再次 encode，造成二次转义
时间戳校验必须用 time.UnixMilli 且预留合理 skew
带有效期的签名 cookie 通常在 payload 里嵌入 exp 字段（毫秒级时间戳）。Go 1.19+ 提供了 time.UnixMilli，但老版本需手动除以 1000 并丢弃余数——若直接用 time.Unix(exp/1000, 0)，会丢失毫秒精度，导致刚过期的 token 被误判为有效。
更隐蔽的问题是服务器时钟与客户端偏差。用户手机时间快 5 分钟，cookie 就提前失效；NTP 同步延迟也可能让服务端时间慢几秒。
- 校验时用
now.After(payload.Exp.Add(-5 * time.Minute))允许最多 5 分钟 skew - payload 中的
exp必须是int64毫秒时间戳，避免 float 或字符串格式引入解析误差 - 禁止在验签前校验时间——攻击者可篡改 exp 字段，必须确保签名有效后再看时间
验签逻辑本身不复杂，真正容易出问题的是各环节的编码一致性、时序安全细节和边界条件处理。尤其是 Base64URL 解码和时间戳精度，线上环境一出错就表现为「偶发性登录失效」，很难复现。
