[Bug] 0.1.7-rc.1/rc.2 出口代理策略注入的 undici 8.x 全局分发器与 Node 内置 fetch 主版本错配：进程内所有响应头丢失（MCP HTTP 服务器永久断开、微信图片/文件发送失败）

[gmugu]

摘要

0.1.7-rc.1 升级引入的 @deepseek-ai/dsh-http-proxy（依赖 undici: ^8.10.0，实际解析到 8.11.0）在检测到 HTTP_PROXY/HTTPS_PROXY 时，把 npm undici 8.x 的 Agent 安装为进程全局 dispatcher。实测确认：外部 undici 8.x dispatcher 与 Node 内置 fetch（内置 undici 6.28.0）存在响应头接口错配——安装后进程内所有经内置 fetch() 的响应 Headers 对象为空（status/body 正常）。0.1.7-rc.2 的 dsh-http-proxy/lib/index.js 与 rc.1 零差异，依赖声明仍为 ^8.10.0，问题未修复。

两个实际故障（同一根因）

症状	读哪个响应头	后果
zai-search / zai-reader / zread 三个 streamable-http MCP 永久 server is disconnected（stdio 型 zai 正常）	MCP SDK 版本协商探针读 content-type → null → SdkError: Unexpected content type: null，静默重试 10 次后放弃	HTTP 型 MCP 全灭
微信通道图片/文件发送 100% 失败（CHANNEL_DELIVERY），文字正常	CDN 上传 200 响应里的 x-encrypted-param → 缺失 → invalid-upload-response	图片/文件全灭

最小复现（与代理无关，纯接口错配）

Node v22.23.2（内置 undici 6.28.0）：

import { createRequire } from 'node:module';
const u811 = createRequire('/usr/lib/node_modules/@deepseek-ai/dsh/node_modules/')('undici');
u811.setGlobalDispatcher(new u811.Agent());   // dsh-http-proxy 启动时做的事

const r = await fetch('https://open.bigmodel.cn/mcp/zai-search/mcp', {
  method: 'POST',
  headers: { 'content-type': 'application/json', accept: 'application/json, text/event-stream' },
  body: JSON.stringify({ jsonrpc: '2.0', id: 1, method: 'server/discover' }),
});
console.log(r.status, [...r.headers].length, r.headers.get('content-type'));
// → 405, 0, null   （响应头全空；不装外部 dispatcher 时 → 405, 8, text/html）

版本矩阵（同一台机器、同一时段实测）

全局 dispatcher	status	响应头数	content-type
Node 内置默认（6.28.0）	405	8 ✅	text/html
npm undici 8.10.0 Agent	405	0 ❌	null
npm undici 8.11.0 Agent（现装）	405	0 ❌	null
npm undici 7.29.0 Agent	405	8 ✅	text/html

抓包（tcpdump）佐证：请求正常发出、对端完整返回了头部块，客户端 Headers 对象却为空——损坏发生在客户端响应头交接，不在网络。NO_PROXY bypass 本身工作正常（流量确实直连），与路由无关。

定位

• packages/util/http-proxy/src/install.ts → createPolicyDispatcher()：Agent({ factory }) → new Pool(origin, options)（8.x）设为全局。
• 8.x dispatcher/handler 协议与 Node 22 内置 fetch 期望的接口不兼容；undici 7.x 仍兼容（对照成立）。
• 另注意：verify-no-bare-dispatcher 只能 gate 仓库内源码，第三方插件（如 dsh-im 的微信 CDN 上传）受此影响却无法被 lint 覆盖。

建议

1. 短期：dsh-http-proxy 的 undici 依赖改为与 Node 内置主版本一致（Node 22 线内置 6.x；或锁定 7.29.x，实测兼容），或在安装全局分发器前校验 process.versions.undici 主版本、不匹配时拒绝安装并告警。
2. 长期：官方最佳实践页应写明「npm undici 8.x 的 setGlobalDispatcher 会损坏内置 fetch 响应头」这一坑（目前该页只说"不会替换内置 globals"，没说全局 dispatcher 会坏）。
3. 用户侧临时方案（已验证）：把 dsh node_modules 里的 undici 替换为 7.29.0 → MCP 三台恢复在线、微信图片发送恢复，代理功能不受影响。

环境与佐证

• dsh 0.1.7-rc.1（已核对 rc.2 的 dsh-http-proxy 与 rc.1 零差异、依赖仍 ^8.10.0）
• Node v22.23.2（内置 undici 6.28.0），Linux x86_64（NAS 自部署）
• 关联：[微信通道] DSH 全局代理分发器环境下图片/文件上传必失败：CDN 返回 200 但响应头为空（缺 x-encrypted-param），建议为 CDN 上传使用独立 dispatcher xmanrui/dsh-im#270（微信通道侧完整诊断，含抓包与调试日志）；受影响用户可在升级到 rc.2 后复测——预计依然复现

以上内容为AI生成总结

[PerryLink]

注入点我核到了，而且你说的"rc.2 零差异"也成立

1. 全局 dispatcher 确实被装上

packages/util/http-proxy/src/install.ts：

undici.setGlobalDispatcher(direct)                                    // :197
…
const { getGlobalDispatcher, setGlobalDispatcher } = await import('undici')   // :209
setGlobalDispatcher(agent)                                            // :213

⇒ 也就是说这个包从 npm 的 undici 依赖里取 Agent，并把它装成进程全局 dispatcher。你描述的机制（外部 undici 8.x 的 dispatcher 与 Node 内置 fetch 自带的 undici 之间存在响应头接口错配）与这段代码的作用方式一致——它影响的正是"进程内所有走内置 fetch() 的调用"。

2. rc.2 零差异我独立核过了：成立

$ git log --oneline dsh-v0.1.7-rc.1..HEAD -- packages/util/http-proxy/
787b746b80 release(dsh): 0.1.7-rc.2
e7def469e1 feat(i18n): key translation pairing records by heading section (#5036)

⇒ rc.1 → rc.2 之间该包只被发布提交与一个无关的 i18n 提交碰到 ⇒ 未修复，你的判断正确。这句让"升级到 rc.2 也不会好"成为已证事实，可以写进报告。

3. 一个能立刻验证核心主张的一行实验（建议放进报告）

const r = await fetch('https://example.com'); console.log(r.status, [...r.headers])

• 在 HTTP_PROXY/HTTPS_PROXY 存在时：status 正常但 [...r.headers] 为空 ⇒ 你那条"响应头全丢"就是这一行的直接证据；
• 清掉代理变量后：header 恢复 ⇒ 因果闭合。

这比"两个业务故障都指向它"更硬——它把根因缩到一行可复现的输出。

4. 建议的修法方向（写进报告）

1. 不要装全局 dispatcher：只在需要走代理的那几次请求上用 ProxyAgent（按调用传 dispatcher），而不是改写整个进程的全局；
2. 或者对齐主版本：让外部 undici 与 Node 内置那一版保持兼容（否则任何"外挂 dispatcher + 内置 fetch"的组合都会踩同类问题）。

5. 一条同因独立报告（建议引用）

同一天另有一份报告指向同一个组件：dsh-http-proxy 的 undici v8 dispatcher 破坏 content-encoding，导致 web_search 拿到原始 brotli 字节（#7468）。⚠️ 我核对的是"同一包、同类机制"（install.ts 的全局 dispatcher），没有逐行比对你们两条的具体失败路径——引用时请写成"同一组件上的同族问题"，并建议维护者一并处理。

6. 版本

你验的是 0.1.7-rc.1/rc.2，而 rc.2 就是当前最新（tag dsh-v0.1.7-rc.2）⇒ 无需再升级；按"最新版上仍未修复"提即可。⚠️ 只是别把核换成 npm 的 latest（仍停在 0.1.5-rc.3，更旧）。