基于VSCode的Node应用在Kubernetes本地单节点环境的端口转发调试-VSCode-PHP中文网

必须使用attach模式连接本地映射端口，node.js容器需启用--inspect=0.0.0.0:9229，kubernetes yaml中声明containerport，配合kubectl port-forward，并在launch.json中配置type为pwa-node、request为attach、port为9229、host为localhost。

基于vscode的node应用在kubernetes本地单节点环境的端口转发调试

直接能用，但必须手动暴露调试端口、配好 port-forward 规则、且 launch.json 里不能用 launch 模式——得切到 attach 模式连本地映射端口。

Node.js 容器必须启用 --inspect 参数并监听 0.0.0.0

默认 node --inspect 只绑定 127.0.0.1，容器内无法被转发流量访问。不改就永远连不上。

在 Pod 的 container 启动命令中显式加 --inspect=0.0.0.0:9229（不是 --inspect-brk，除非你真要启动即断）
确保容器镜像里 Node.js 版本 ≥ v8.0.0（旧版不支持远程 attach）
YAML 中必须通过 ports 声明该端口，否则 Kubernetes 不允许 kubectl port-forward 绑定：
```
ports:
- containerPort: 9229
  protocol: TCP
```

kubectl port-forward 和 VSCode 端口转发别混用

VS Code Kubernetes 插件的 “Forward Port” 功能底层调的就是 kubectl port-forward，但它只对当前 Pod 生效、不持久、关插件就断。而你如果已在终端手动执行过 kubectl port-forward pod/name 9229:9229，VS Code 再点一次会报错 “address already in use”。

用于自动切换项目中适合的node 版本

根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。

下载

推荐统一用命令行方式：保持一个终端常驻运行 kubectl port-forward，更可控
不要在 VS Code 里右键 Pod → Forward Port 同时又在终端跑同一条命令
若要用插件转发，先确认没其他进程占着本地 9229 端口：lsof -i :9229（macOS/Linux）或 netstat -ano | findstr :9229（Windows）

launch.json 必须配置为 attach 模式且 host 设为 localhost

launch 模式会尝试在本地起 Node 进程，完全无效；attach 才是连远端调试器的正确姿势。而且 host 不能写成 0.0.0.0 或容器 IP——它连的是你本地被转发后的端口。

关键字段必须是："request": "attach"、"port": 9229、"host": "localhost"

完整最小配置示例：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "pwa-node",
      "request": "attach",
      "name": "Attach to Kubernetes Node",
      "port": 9229,
      "host": "localhost",
      "skipFiles": ["<node_internals>/**"],
      "trace": true
    }
  ]
}</node_internals>

如果断点不命中，打开 "trace": true 查看 VS Code 调试器日志，常见原因是源码路径映射不一致（localRoot/remoteRoot 在 attach 场景下通常不需要设，除非你用的是编译后代码）

Minikube / Kind 环境下容易忽略的网络权限问题

本地单节点集群（如 Minikube、Kind）默认运行在虚拟机或容器中，--inspect=0.0.0.0:9229 虽然绑定了所有接口，但宿主机防火墙或虚拟网卡策略可能拦截入向连接。

Minikube 用户：执行 minikube ssh -- sudo iptables -P INPUT ACCEPT 临时放行（仅开发用，勿用于正式环境）
Kind 用户：检查 kind 集群的 extraPortMappings 是否把 9229 映射进来了（默认不映射）
无论哪种，都建议先在容器内用 curl http://localhost:9229/json 验证 Delve/Node 调试服务是否真的在响应——这是最靠前的验证点

真正卡住的地方往往不是配置写错，而是容器没真正监听 0.0.0.0，或者 kubectl port-forward 进程意外退出没人发现，又或者 launch.json 里手滑选成了 launch 模式。每次连不上，按顺序查这三处，90% 的问题当场解决。