解析 Cookie 和 Set-Cookie
为什么重要 Cookie 是你真正能看到的那种跟踪 ID。正确地读懂一行 Set-Cookie,能告诉你一个网站想记住你多久、脚本能否读取这个 Cookie,以及它能否跟着你去其他网站。把那些小规则做对,也是让登录保持安全的关键。
回到衣帽间。Set-Cookie 就是服务员递给你一张号牌,背面印着细则:“有效期一年”“只在主服务台出示”“不要出示给其他场馆”。Cookie 就是你把给那个服务台的所有号牌一次性交回去,不带上那些细则。
Set-Cookie:一个请浏览器保存一个 Cookie 的响应头。每个 Cookie 一个响应头:Set-Cookie: sid=7f3a; Path=/; Secure; HttpOnly; SameSite=Lax。
Cookie 请求头:一个携带浏览器选择发送的每一个 Cookie 的请求头,形式是用 ; 连接的 name=value 对,例如 Cookie: sid=7f3a; theme=dark。只传送名字和值,从不传送属性。
属性:Set-Cookie 中第一个 ; 之后的一条细则。有些带有值(Max-Age=3600),有些是只要出现就生效的标志(Secure)。
你要解析的属性
Expires=Thu, 01 Oct 2026 00:00:00 GMT:在这个日期忘掉这个 Cookie。暂时保留文本;Cookie 罐子会把它变成一个时间。Max-Age=3600:在这么多秒之后忘掉它。零或负数表示立即删除。如果两者都存在,Max-Age 优先。Domain=shopa.example:也发送给子域名。开头的点(.shopa.example)会被忽略,名称以小写进行比较。Path=/account:只为这个路径之下的地址发送。不以/开头的值会被忽略。Secure:只通过 HTTPS。HttpOnly:页面脚本读不到它。SameSite=Strict、Lax或None:它是否会随来自其他网站的请求一起发送。任何其他值都算作没有给出。Partitioned:为每个顶层站点保留一份单独的副本(CHIPS,来自第 1 阶段)。
需要小心的地方
浏览器是故意宽容的,你的解析器也应该如此。属性名称不区分大小写,所以 secure 和 SECURE 都算数。= 和 ; 两边允许有空格。浏览器不认识的属性(Priority=High,或者一个笔误)会被跳过,而不是报错。值里可以包含 =,比如 token=a=b,所以只在第一个 = 处切分。
有些行会被完全忽略:第一部分完全没有 =,或者名字为空。现行的 Cookie 规则 draft-ietf-httpbis-rfc6265bis(已被批准为标准,正在等待它的 RFC 编号,2026 年 10 月核实)允许少数不寻常的无名 Cookie;我们的练习浏览器保持简单,忽略它们,你也一样。
parse_set_cookie("id=7f3a; Max-Age=600; domain=.ShopA.example; Path=/; secure; SameSite=lax")
# {"name": "id", "value": "7f3a", "expires": None, "max_age": 600,
# "domain": "shopa.example", "path": "/", "secure": True, "httponly": False,
# "samesite": "Lax", "partitioned": False}一个常见的误解
“Cookie 请求头会告诉服务器我的 Cookie 什么时候过期。”它不会。浏览器把所有细则都留给自己,只发送 name=value。一台想知道某个 Cookie 能保留多久的服务器,必须自己记住它设置了什么。
试一试 在 DevTools 里打开 Application(Chrome、Edge)或 Storage(Firefox),然后是 Cookies,再选一个网站。每一行都是一个被解析过的 Set-Cookie:把 Expires、Domain、Path、Secure、HttpOnly、SameSite 和 Partitioned 这几列,和你的解析器返回的字段进行比较。
用其他语言实现
JavaScript:
function parseSetCookie(line) {
const [first, ...attrs] = line.split(";");
const i = first.indexOf("=");
if (i < 0 || !first.slice(0, i).trim()) return null;
const c = { name: first.slice(0, i).trim(), value: first.slice(i + 1).trim() };
for (const a of attrs) {
const j = a.indexOf("=");
const key = (j < 0 ? a : a.slice(0, j)).trim().toLowerCase();
const val = j < 0 ? "" : a.slice(j + 1).trim();
if (key === "secure") c.secure = true;
else if (key === "max-age" && /^-?\d+$/.test(val)) c.maxAge = Number(val);
// ... and the rest, as in Python
}
return c;
}Go:
// Go parses both for you: http.ParseSetCookie (Go 1.23+) and http.ParseCookie
c, err := http.ParseSetCookie("id=7f3a; Max-Age=600; Secure; SameSite=Lax")
if err == nil {
fmt.Println(c.Name, c.Value, c.MaxAge, c.Secure, c.SameSite)
}PHP:
// a server sets a cookie with every attribute named:
setcookie('sid', $id, ['expires' => time() + 3600, 'path' => '/',
'secure' => true, 'httponly' => true, 'samesite' => 'Lax']);回顾
- Set-Cookie 携带一个 Cookie 及其属性;Cookie 请求头只携带 name=value 对。
- 在第一个
=处切分,用小写比较属性名称,并跳过你不认识的东西。 - Max-Age 必须是一个整数,Path 必须以
/开头,而 Domain 开头的点会被忽略。 - 没有
=或没有名字的一行会被完全忽略。
编写 parse_cookie_header(text):把请求的 Cookie 值变成一个字典(按 ; 切分,再在第一个 = 处切分,两者都去掉首尾空格,跳过没有 = 或没有名字的片段,同一个名字以第一个值为准)。编写 parse_set_cookie(line):一个包含这些键的字典:name、value、expires(原始文本或 None)、max_age(当值是普通的 ASCII 数字、最多带一个前导 - 时为一个 int,这是浏览器的要求;其他任何东西,比如 +5、1_000 或 --5,都会被忽略并给出 None)、domain(小写,去掉开头的点,或者 None)、path(只有当它以 / 开头时)、secure、httponly、partitioned(布尔值)以及 samesite("Strict"、"Lax"、"None" 或 None),对于没有 = 或名字为空的一行,则返回 None。
这个练习即将开放
完成它前面的那一课,这一课就会解锁。整门课程免费,无需账号,而且你现在就可以阅读这节课。
这个浏览器屏蔽了 learn.floati.life 的 Cookie,所以你在这里完成的课程无法按顺序打开。请允许这个网站使用 Cookie,然后重新加载。