课程大纲 第 35 课,共 156 课 · 从内部看 HTTP
从内部看 HTTP

解析 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。

发现这节课有问题?报告它 · 就这节课提问

这个练习即将开放

完成它前面的那一课,这一课就会解锁。整门课程免费,无需账号,而且你现在就可以阅读这节课。