办公网络下无法连接Chrome DevTools？Node.js Docker的Jest调试失效

前置结论 #

你遇到的场景（居家离线、手机热点均正常，仅办公WiFi失效、更换调试端口无改善）已经可以排除代码配置、Docker端口映射、Node/Jest 工具本身的问题，故障完全来自办公WiFi的特殊网络策略对Node inspect调试机制的干扰，和端口号无关。 #

分步可落地排查方案 #

• 第一步：定位启动阻塞的具体环节
  办公WiFi环境下重新启动调试命令，追加Node的网络调试日志，确认卡顿位置：

  NODE_ENV='test' NODE_DEBUG='net' node --inspect-brk=0.0.0.0:9229 node_modules/.bin/jest --run-in-band --bail
  

  大概率会看到流程卡在「枚举本机所有可用网卡地址」的阶段。这是因为Node启动inspect服务时，默认会主动遍历所有网卡的IPv4/IPv6地址生成调试WebSocket链接，而办公WiFi通常启用了802.1X认证、SSID隔离、IPv6半启用、mDNS探测劫持策略，Node在访问这些被策略限制的网卡地址时会直接阻塞启动流程，这个环节和你监听哪个端口没有任何关系，所以换端口当然解决不了问题。
• 第二步：跳过全网卡枚举流程，显式绑定固定IP
  不要使用0.0.0.0作为inspect监听地址，直接显式绑定Docker容器内的固定网桥IP，跳过Node的全网卡探测逻辑：
  1. 进入运行中的Docker容器，执行ip addr查到容器在默认网桥下的固定IP（通常为172.17.0.x 网段）
  2. 将调试启动命令中的--inspect-brk=0.0.0.0:9229替换为--inspect-brk=<容器固定IP>:9229
  3. 在Chrome DevTools的调试连接配置中，关闭「自动发现远程调试目标」选项，手动输入容器端口映射后的宿主机IP+端口建立连接，跳过mDNS自动探测流程。
• 第三步：绕过办公路由器的流量拦截
  多数企业办公WiFi会在路由器层拦截局域网内的非HTTP、非HTTPS的调试流量，哪怕本机端口连通正常，流量经过WiFi链路就会被丢包：
  1. 启动调试服务后，在宿主机本地执行nc -vz 127.0.0.1 9229测试端口连通性，如果测试失败，即可确认是路由器层的拦截策略
  2. 不需要调整端口或网络配置，直接通过本地回环转发的方式承载调试流量：执行ssh -L 9229:127.0.0.1:9229 localhost把容器内的调试端口直接映射到本机回环网卡，所有调试流量全程走本机回环链路，完全不经过办公WiFi的路由节点，即可绕过拦截规则。
• 第四步：排除企业VPN带来的路由表冲突
  办公WiFi环境下往往会自动启动企业客户端的VPN组件，哪怕你没有主动连接，VPN组件也会改写系统全局路由表，和Docker的桥接网络路由规则产生冲突：
  1. 在办公网状态下执行netstat -rn（Mac/Linux）或route print（Windows），查看是否存在规则把调试端口的流量导向不存在的VPN虚拟网卡
  2. 如果确认是路由冲突，临时调整Docker容器的网络模式为host，即可让容器的调试流量直接走宿主机本地网络栈，避免和VPN虚拟网卡的路由规则冲突。

内容的提问来源于stack exchange，提问作者Bikash Lama