[Bug][Windows Desktop 0.2.1-rc.3] 本地认证 Cookie 随端口积累，HTTP 431 导致启动失败 #10868

jeffreyren1 · 2026-10-24T09:10:50Z

jeffreyren1
Oct 24, 2026

桌面程序连续多次启动失败，崩溃日志中的错误为：

Error: desktop welcome: Web authentication failed

错误发生于 connectDesktopWelcome()。通过 Chromium NetLog 检查，对本地 Host 的启动认证请求实际收到了：

HTTP/1.1 431 Request Header Fields Too Large
Connection: close

主程序默认会话的 Cookie 数据库中，host_key = '127.0.0.1' 的记录有 73 个，其中名称以 dsh-auth- 开头的认证记录有 68 个。
失败请求的 NetLog 显示 Cookie: [16102 bytes were stripped]。这是 NetLog 对被隐藏 Cookie 数据的字节数记录；加上其他请求头部后，请求超过服务端限制。
使用应用内置运行环境直接读取 require('node:http').maxHeaderSize，结果为 16384。
该请求通过本机直连访问 127.0.0.1，NetLog 中对应的代理决策为 DIRECT。

诊断只读取了 Cookie 名称、数量及长度，未将 Cookie 值或启动认证令牌包含在本讨论中。

检查对象为实际安装的 resources/app.asar，桌面主进程入口为 lib/main.js，认证实现位于内置的 @deepseek-ai/dsh-client-connection/lib/index.js。

本地 Host 使用动态端口。
cookieName(authority) 以 dsh-auth- 加上 sha256(authority) 的 Base64URL 结果作为名称；HTTP 的 authority 包含端口。
cookieMaxAgeDays 默认值为 30，签发 Cookie 时设置 Max-Age 和 Expires。
connectDesktopWelcome() 通过 Electron net.fetch()，使用 credentials: "include" 发起认证；后续账户连接也从 session.defaultSession.cookies 读取 Cookie。
检查桌面主进程启动认证流程时，没有发现回收旧端口 dsh-auth-* 记录的逻辑。
connectDesktopWelcome() 对失败响应统一抛出 Web authentication failed，没有在该错误中保留实际 HTTP 状态码。

结合源码和实际请求，可以解释这次失败：端口变化会产生不同名称的认证 Cookie，历史记录在有效期内继续保留；同一主机的 Cookie 会跨端口发送，最终使认证请求的头部超过限制。

做了两项真实启动验证：

保留原有后端配置，使用独立的临时浏览器数据目录启动。认证返回 303，后续文档和配置接口返回 200。
完全退出程序，备份原始 Cookie 数据库，然后仅删除同时满足以下条件的记录：
```
host_key = '127.0.0.1' AND name GLOB 'dsh-auth-*'
```
实际删除 68 条记录，其余 37 个 Cookie 的完整数据库记录在重新启动前已逐项核验保持原样，数据库完整性检查通过。

随后使用原有浏览器数据目录和原有后端配置启动：

本地认证返回 303，重定向后的页面返回 200。
settings/describe、llm/listConfigurableProviders、credentials/describe、account/getState 均返回 200。
本地流连接返回 101 Switching Protocols。
程序显示“欢迎使用 DeepSeek Harness”设置界面。
本次启动未出现 HTTP 431，也未产生新的崩溃日志。

上述恢复没有修改程序代码、插件代码或网站持久浏览资料。没有上传原始 Cookie 数据库或完整 NetLog。