Skip to content

fix(login): 让 cookie 续期请求显式携带浏览器作用域 Cookie 头 - #200

Closed
chinbor wants to merge 1 commit into
TheSmallHanCat:mainfrom
chinbor:fix/protocol-login-cookie-header
Closed

chinbor wants to merge 1 commit into
TheSmallHanCat:mainfrom
chinbor:fix/protocol-login-cookie-header

Conversation

@chinbor

@chinbor chinbor commented Nov 17, 2026

Copy link
Copy Markdown
Contributor

问题

ProtocolLogin.login() 只靠 AsyncSession(cookies=cookie_jar) 让 curl_cffi 自动带 cookie,然后请求 GET {FLOW_BASE}/projects 触发服务端续期。

但 session jar 和真实浏览器发 Cookie 头的规则不一致:

  1. 只合并、不删除——紧接其后的注释已经点明:The Python session jar only merges updates; a fresh snapshot also honors cookies deleted by Set-Cookie, including during redirects. 被 Set-Cookie 删除的 cookie 仍可能被 jar 带出去。
  2. 不做作用域过滤——只该发往 /projects 的 cookie 与 path 更长的同名项顺序,jar 未必按浏览器规则排列。
  3. 同名重复 cookie 的优先级也不保证与浏览器一致。

一旦首次请求的 Cookie 头与浏览器不一致,/projects 可能不返回有效 Set-Cookie,续期就静默失败。

改动

src/services/browser_cookie_utils.py 里早就有 serialize_cookie_header_for_url() / cookie_pairs_for_url(),其 docstring 明确写着:

Return the cookie pairs a browser would send to target_url. Structured browser exports retain scope and duplicate cookie names.

内部按 _cookie_mapping_matches_url() 过滤作用域,再按 (-path_length, index) 排序,正是浏览器组 Cookie 头的规则。但这个函数在 protocol_login.py 里一直没人调用。

本次把它接上,让首次 /projects 请求显式携带与浏览器一致的 Cookie 头:

cookie_hdr = serialize_cookie_header_for_url(
    google_cookies_raw, f"{FLOW_BASE}/projects"
)
req_headers = {"Referer": f"{FLOW_BASE}/"}
if cookie_hdr:
    req_headers["Cookie"] = cookie_hdr

cookies=cookie_jar 保持不变,仍用于接收 Set-Cookie 与导出快照。

测试

tests/test_cookie_refresh.py 里原有断言 self.assertNotIn("Cookie", session.get.call_args.kwargs["headers"]) 与本次语义冲突,改为断言实际发出的头:

self.assertEqual(
    session.get.call_args.kwargs["headers"]["Cookie"],
    "OSID=session-old; SID=account-cookie",
)

fixture 中 deleted 的 path 是 /project,不属于 /projects 的作用域,正确被排除。

$ ./.venv/Scripts/python.exe -m unittest discover -s tests -q
Ran 347 tests in 22.9s
FAILED (errors=2)   # 仅 test_i18n / test_i18n_browser 因环境未装 pytest 导入失败,与本次改动无关

tests.test_cookie_refresh 单文件 52 项全部通过。

需要确认

显式设置 headers["Cookie"] 与 AsyncSession(cookies=cookie_jar) 同时存在时,curl_cffi 是否会出现重复 Cookie 头。若会,需要改成创建 session 时不传 cookies、仅从响应 COOKIELIST 取快照。目前配置下未观察到重复(_export_cookie_jar 走的是 CurlInfo.COOKIELIST,不读请求头)。

ProtocolLogin 之前只靠 AsyncSession(cookies=jar) 让 curl_cffi 自带 cookie。
session jar 只合并更新,不会因为 Set-Cookie 删除而停止发送,同名重复项与
作用域过滤也和浏览器不一致,导致 /projects 续期拿不到有效 Set-Cookie。

改为用 serialize_cookie_header_for_url 构造与真实浏览器逐字节一致的 Cookie
头(作用域过滤 + 同名按 path 长者优先),显式写入首次请求的 headers。

顺带把 test_rotated_and_deleted_cookies_are_exported_with_scope 里
assertNotIn("Cookie", ...) 的断言改为断言实际发出的 Cookie 头。
@chinbor

chinbor commented Nov 17, 2026

Copy link
Copy Markdown
Contributor Author

关闭这个 PR,因为实测证明它是错误的改动。下面是证据。

一、改动会发出重复的 Cookie 头

AsyncSession(cookies=cookie_jar) 已由 libcurl 自动组一个 Cookie 头,再显式设 headers["Cookie"] 不会覆盖它,而是追加第二个头。

用本地 socket 回声服务器抓 curl_cffi 的真实请求字节(A 为当前改动):

--- A 现状:jar + 显式头 ---
Cookie 头数量: 2
  Cookie: OSID=jar-osid; SID=jar-sid
  Cookie: OSID=explicit-osid; SID=explicit-sid
  服务端看到的合并值: OSID=jar-osid; SID=jar-sid, OSID=explicit-osid; SID=explicit-sid

--- B 空 jar + 显式头 ---
Cookie 头数量: 1

--- C 不传 cookies + 显式头 ---
Cookie 头数量: 1

按 RFC 7230 服务端会合并成一条含重复 key 的字符串。302 重定向时第二跳同样叠加(Cookie: NEWCOOKIE=from-redirect + 显式头)。

二、原描述的根因判断也是错的

原 PR 说「jar 不做作用域过滤」。实测不成立——_cookie_jar() 里 path=item.get("path", "/") 一直保留 path,libcurl 自动发送时过滤是正确的:

jar 内容: ['NID@/', 'OSID@/', 'SID@/', 'deleted@/project']
GET /projects → Cookie: OSID=session-old; NID=nid-val; SID=account-cookie
GET /project  → Cookie: deleted=removed; OSID=session-old; NID=nid-val; SID=account-cookie

deleted@/project 正确地没进 /projects。serialize_cookie_header_for_url(raw, 'https://flow.google.com/projects') 输出 OSID=session-old; SID=account-cookie; NID=nid-val,内容一致。

唯一的真实差异是同名 cookie 的排序:libcurl 是 OSID, NID, SID,浏览器规则是 OSID, SID, NID。而这个差异目前没有证据表明会导致 /projects 续期失败——原 PR 描述里「一旦 Cookie 头不一致,续期就可能静默失败」是推测,没有复现。

三、关于「session jar 只合并不删除」

这一条也没有实际影响。_cookie_jar() 是从 google_cookies 快照重新构造的,不是跨请求复用的长期 jar,不存在「被 Set-Cookie 删掉的 cookie 仍被带出去」的场景。

四、如果将来真要修排序

正确写法是 per-request 覆盖而不是显式头:

session.get(url, cookies=cookie_pairs)  # 实测单头、内容正确

但前提是先证明排序差异真的会造成问题。在那之前,AsyncSession(cookies=cookie_jar) 的默认行为是正确的。

抱歉占用了评审时间。

@chinbor chinbor closed this Nov 17, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant