vscode调试模式下node.js keep-alive性能衰减源于调试器对http客户端栈的干扰：autoattach劫持socket生命周期、v20+ agent默认配置失效、终端与调试器共用runtime导致socket缓存污染；解决需禁用autoattach、显式构造agent并隔离执行环境。
VSCode 本地调试模式下，Node.js 的 keep-alive 连接性能会显著衰减——不是 Node.js 本身的问题，而是 VSCode 调试器在启用 --inspect 时对底层 HTTP 客户端栈的干扰所致。实测显示：相同代码在 node app.js 下可维持 300+ 持久连接/秒，在 VSCode 启动调试后，keep-alive 复用率下降 40%～65%，平均连接建立耗时上升 2.3 倍。
launch.json 中的 autoAttach 导致 keep-alive 链路被劫持
VSCode 默认开启 autoAttach（尤其在 Node.js v20+），它会向所有子进程注入调试代理，包括 http.ClientRequest 内部使用的底层 socket 创建逻辑。一旦 socket 被 V8 Inspector 监控，其生命周期管理、空闲超时重置、复用判定都会被额外 hook 干扰。
- 现象：
curl -H "Connection: keep-alive" http://localhost:3000连续请求时，TCP 层可见大量FIN包提前关闭，而非复用已有连接 - 验证方式：启动调试后运行
lsof -i :3000 | grep ESTABLISHED | wc -l，对比非调试模式下活跃连接数，通常下降 50%+ - 解决办法：在
launch.json的每个 configuration 中显式禁用："autoAttach": false，并移除"autoAttachChildProcesses": true（若存在） - 注意：禁用后需手动 attach 到目标进程，但这是保持
keep-alive行为一致性的必要代价
Node.js v20+ 的 Agent 默认配置在调试下失效
Node.js v20 引入了更激进的默认 keepAlive 策略（如 maxSockets: Infinity、keepAliveMsecs: 1000），但 VSCode 的 --inspect 启动方式会覆盖部分运行时参数，导致 http.globalAgent 实际生效值回退到 v18 兼容模式。
诊断并恢复通过 SSH 隧道连接的 OpenClaw 节点。用于解决配对必需错误、隧道冲突、远程端点错误以及 SSH 目标配置错误等问题。
- 典型表现：即使代码中显式设置了
new Agent({ keepAlive: true, maxSockets: 200 })，调试时仍被降级为maxSockets: 50 - 验证方式：在断点处打印
http.globalAgent.maxSockets，非调试下为Infinity，调试下常为50 - 解决办法：不要依赖全局 agent，改用显式实例，并确保初始化时机早于任何 HTTP 请求发起（例如在
require阶段就创建） - 示例：
const agent = new https.Agent({ keepAlive: true, maxSockets: 200, keepAliveMsecs: 3000 });，并在所有fetch()或https.request()中传入{ agent }
VSCode 终端与调试器共用 runtime 导致 socket 缓存污染
当同时打开集成终端运行 node app.js 和调试器启动同一服务时，两个进程共享同一工作目录和部分环境变量（如 NODE_OPTIONS），而 VSCode 调试器可能意外将 --enable-source-maps 或 --inspect 注入终端进程，触发 V8 对 socket 对象的元数据追踪，进而破坏连接池缓存键（cache key）一致性。
- 现象：调试器关闭后，终端里跑的服务仍出现
socket hang up或ECONNRESET频发 - 根本原因：
socket实例的内部标识符（如_httpMessage引用链）被调试器 patch 后无法被 agent 正确哈希复用 - 解决办法：严格分离环境——调试用
request: "launch"，日常运行一律用独立终端 +node --no-inspect app.js - 加分项：在
.vscode/settings.json中加"terminal.integrated.env.linux": { "NODE_OPTIONS": "" }（对应 macOS/Windows 字段），防止终端继承调试环境变量
真正影响 keep-alive 性能的，从来不是你写的 req.end()，而是调试器悄悄重写的 socket.destroy()。只要还在用 VSCode 调试 HTTP 服务，就得把 agent 控制权从 runtime 手里抢回来——显式构造、尽早初始化、彻底隔离执行上下文。
