基于node:14-alpine及后续版本的Docker Node应用调试连接失败问题

以下是针对你遇到的Node应用在Docker中调试无法连接问题的排查和解决方法：

1. 切换非Alpine Node镜像 #

Alpine镜像基于musl libc，部分场景下与Node调试模块存在兼容性问题。建议改用Debian基础的Node镜像：

修改Dockerfile：

FROM node:16
WORKDIR /app
COPY index.js .
CMD ["node", "index.js"]

重新构建并运行：

docker build -t debug-test . && docker run -p 9229:9229 debug-test node --inspect-brk=0.0.0.0 index.js

之后打开Chrome调试器（chrome://inspect），点击"Configure"添加localhost:9229，再尝试连接调试。

2. 检查主机端口占用 #

确认主机9229端口未被其他进程占用：

# Linux/macOS
lsof -i :9229
# Windows
netstat -ano | findstr :9229

若端口被占用，可终止占用进程，或更换映射端口：

docker run -p 9230:9229 debug-test node --inspect-brk=0.0.0.0 index.js

调试时在Chrome中配置localhost:9230即可。

3. 在Dockerfile中直接配置调试启动命令 #

避免docker run追加命令可能的解析问题，直接在Dockerfile中指定调试启动参数：

FROM node:16-alpine
WORKDIR /app
COPY index.js .
CMD ["node", "--inspect-brk=0.0.0.0", "index.js"]

构建后运行：

docker build -t debug-test . && docker run -p 9229:9229 debug-test

再尝试连接调试器。

4. 排查主机防火墙/安全软件拦截 #

临时关闭主机防火墙或杀毒软件，确认是否是它们拦截了调试端口的连接。若验证是此原因，添加允许9229端口（或自定义映射端口）入站连接的规则。

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