能否调试Docker容器内的Node.js应用？含Visual Studio Code场景

当然可以调试运行在Docker容器中的Node.js应用，并且完全支持在Visual Studio Code中进行可视化调试，以下是具体实现步骤：

一、基础配置：让容器内Node.js进入调试模式 #

首先需要确保容器里的Node.js以调试模式启动，同时打通主机与容器的调试端口：

• 修改Dockerfile，将启动命令改为调试模式，并暴露默认调试端口9229：

# 假设你的项目入口是app.js
WORKDIR /app
COPY . .
RUN npm install
# 以调试模式启动，0.0.0.0允许外部连接
CMD ["node", "--inspect=0.0.0.0:9229", "app.js"]
# 暴露调试端口
EXPOSE 9229

• 启动容器时映射端口：
  • 用docker run命令：docker run -p 9229:9229 --name node-app your-image-name
  • 用Docker Compose的话，在compose.yml中添加端口映射：

  services:
    node-app:
      build: .
      ports:
        - "9229:9229"
  

二、VS Code中配置并启动调试 #

1. 打开项目所在的VS Code工作区，进入左侧「调试」面板（快捷键Ctrl+Shift+D），点击「创建launch.json文件」，选择「Node.js」环境。
2. 将launch.json修改为以下attach模式配置：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "attach",
      "name": "Attach to Docker Node",
      "port": 9229,
      "address": "localhost",
      "localRoot": "${workspaceFolder}",
      "remoteRoot": "/app" // 这里要和Dockerfile中WORKDIR指定的路径一致
    }
  ]
}

3. 启动容器后，在VS Code调试面板选择「Attach to Docker Node」，点击启动按钮即可连接到容器内的Node.js进程。此时你可以像调试本地Node.js应用一样，设置断点、查看变量、单步执行代码。

注意事项 #

• 确保容器内的代码路径（remoteRoot）与本地代码路径（localRoot）对应，否则VS Code无法映射断点位置。
• 如果本地代码是通过Docker Volume挂载到容器的，修改本地代码后容器内会实时同步，无需重新构建镜像；如果是将代码COPY进镜像，修改代码后需要重新构建镜像并重启容器。
• 尽量保持本地Node.js版本与容器内版本一致，避免调试兼容性问题。

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