Go net/http Cookie.RawExpires 怎样读取原始 Expires 字段

如果你需要保留 Set-Cookie 里的原始过期文本，直接读取 http.Cookie.RawExpires；如果要做时间比较、判断是否已经过期，则读取解析后的 http.Cookie.Expires。这两个字段不是重复数据：一个保留输入形态，一个代表 Go 已经识别出的时间结果。

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

RawExpires 适合记录原始值和排查兼容问题，Expires 适合业务判断。解析失败时，原始文本仍可能存在，但 Expires 会保持零值，不能把它当成有效日期。

先分清 RawExpires 和 Expires

http.Cookie 表示响应中的 Set-Cookie 或请求中的 Cookie。其中 RawExpires 是字符串，注释说明它只用于读取 Cookie；Expires 是 time.Time，用于承载解析后的过期时间。

在标准格式下，解析过程会保留原始字符串，同时尝试把它转换为 UTC 时间。下面这两个字段应这样理解：

• RawExpires：原始属性值，例如 Wed, 07-Mar-2012 14:25:06 GMT。
• Expires：解析后的 time.Time，适合调用 Before、After 或 IsZero。

从 HTTP 响应中读取 RawExpires

客户端请求成功后，可以通过 Response.Cookies() 取得响应里的 Cookie。这个方法已经替你处理了 Set-Cookie 头的解析，得到的每个 Cookie 都可以同时查看两个过期字段。

package main

import (
	"fmt"
	"net/http"
)

func printCookieExpiry(resp *http.Response) {
	for _, cookie := range resp.Cookies() {
		// RawExpires 保留响应头里的原始文本，适合日志和兼容排查。
		fmt.Printf("name=%s raw_expires=%q\\n", cookie.Name, cookie.RawExpires)

		// Expires 是解析结果；零值表示没有可用的解析时间。
		if cookie.Expires.IsZero() {
			fmt.Println("expires=unparsed-or-absent")
			continue
		}
		fmt.Printf("expires=%s\\n", cookie.Expires.UTC().Format("2006-01-02 15:04:05Z"))
	}
}

func main() {
	resp := &http.Response{
		Header: http.Header{
			"Set-Cookie": []string{
				"session=abc; Expires=Wed, 07-Mar-2012 14:25:06 GMT; Path=/",
			},
		},
	}
	printCookieExpiry(resp)
}

真实请求中，把示例里的响应替换成 client.Do(req) 返回的 *http.Response 即可。示例故意使用一个内存中的响应头，只说明字段关系，不代表线上请求结果。

解析成功与失败要分开判断

Go 会把 Expires 的属性值先保存到 RawExpires，再按支持的时间格式解析。如果解析成功，Expires 会得到 UTC 时间；如果格式无法识别，RawExpires 仍可用于诊断，而 Expires.IsZero() 会返回 true。

func cookieExpiry(cookie *http.Cookie) (string, time.Time, bool) {
	// 空指针先单独处理，避免错误响应路径触发 panic。
	if cookie == nil {
		return "", time.Time{}, false
	}

	// RawExpires 可能有值，但只有非零 Expires 才能参与时间比较。
	if cookie.Expires.IsZero() {
		return cookie.RawExpires, time.Time{}, false
	}
	return cookie.RawExpires, cookie.Expires.UTC(), true
}

这个返回值设计把“原始数据是否存在”和“是否得到可比较的时间”分开了。调用方可以在日志里保存第一项，也可以只在第三项为 true 时执行过期判断。

按用途选择字段

一个小型 Cookie 处理模块可以按下面的边界分工：

不要把 RawExpires 当成可直接比较的日期字符串，也不要把零值 Expires 简化成“已经过期”。没有 Expires 属性、解析失败和真正早于当前时间，是三个不同状态。

常见问题

RawExpires 能直接写回 Cookie 吗？

它主要是读取字段。构造要发送的 Cookie 时，应设置规范化的 Expires，再让 Cookie.String() 负责序列化，不要依赖手动修改 RawExpires 产生发送格式。

Expires 是不是总是本地时间？

不是。解析结果按 UTC 归一化后保存，展示时可以按业务时区格式化；比较时优先直接使用 time.Time。

只有 RawExpires 没有 Expires，应该怎么办？

把它当成“有原始输入但没有可用解析结果”，保留原文用于日志或人工排查，不要据此自动延长、删除或刷新 Cookie。

小结

Cookie.RawExpires 的读取方式很直接：从 Response.Cookies() 得到 Cookie 后读取字符串字段即可。真正需要注意的是字段职责：RawExpires 保存输入，Expires 保存可比较的解析结果，IsZero() 用来区分缺失或解析失败。技术依据：https://pkg.go.dev/net/http#Cookie、https://go.dev/src/net/http/cookie.go。