Docker Labs在容器内实时调试Eclipse/IntelliJ/VSCode连接Docker调试Java和Node.js的终极配置教程本 Docker 调试教程基于开源项目Docker Labs带你掌握容器内实时调试的完整流程用 Eclipse 或 IntelliJ 通过 JPDA 远程调试连接 Tomcat 容器里的 Java 应用用 VSCode 以 Attach 模式调试 Node.js 容器。配置一次即可在 IDE 里打断点、看变量、热修复彻底告别docker logs的盲猜式排错 为什么需要 Docker 容器调试传统做法是改代码 → 重新构建镜像 → 重启容器循环往复非常低效。而容器调试的核心思路只有一句话代码挂载进容器 调试端口暴露到宿主机 IDE 远程直连容器内进程Docker Labs 在 developer-tools/ 目录下提供了两套完整的调实验证环境场景技术栈调试通道配套教程Java 容器调试Spring MVC Tomcat MySQLJPDA 远程调试8000 端口Eclipse-README.md、IntelliJ-README.mdNode.js 容器调试Node nodemonV8 Inspect5858 端口VSCode-README.md准备工作克隆 Docker Labs 仓库先安装 Docker然后克隆仓库并进入调试目录git clone https://gitcode.com/gh_mirrors/la/docker.labs cd labs/developer-tools/java-debuggingJava 示例应用是一个用户注册/登录系统表单提交写入数据库再查询校验。它故意内置了一个密码 ROT13 混淆 bug——注册时密码被转码存储登录时却直接比对原文导致登录永远失败正好用来练习断点调试 Eclipse 调试 Java 容器JPDA 远程调试四步走第 1 步导入 Maven 项目并构建在 Eclipse 中选择File Import Maven Existing Maven Projects定位到app目录下的 pom.xml完成导入后新建 Maven build 配置执行clean install目标构建产物会输出到app/target/UserSignup。第 2 步docker-compose 启动容器在项目根目录执行docker-compose up编排文件 docker-compose.yml 会构建并启动两个容器MySQL 数据库和 Tomcat 应用服务器并把本地构建产物挂载进 Tomcat 的webapps/UserSignup目录同时把8000 端口JPDA 调试端口映射到宿主机。浏览器访问localhost:8080即可看到应用首页此时注册一个用户再尝试登录会直接失败——这就是我们要用调试器定位的 bug。第 3 步配置 Eclipse 远程调试连接Tomcat 镜像 registration-webserver/Dockerfile 在构建时已通过环境变量开启 JPDA 调试。在 Eclipse 中打开Run Debug Configurations选择Remote Java Application新建配置HostlocalhostPort8000用 browse 按钮选择刚导入的项目点击Debug发起连接第 4 步打断点、看变量、修复 bug切换到 Debug 视图Window Perspective Open Perspective Debug你会看到 Tomcat 的守护线程已连上。在User类的setPassword方法处设置断点然后用调试器走一遍注册流程用用户名Moby、密码m0by注册程序立即停在断点处变量窗口里可以清晰看到 password 的值就是m0by按F8继续再在getPassword处设断点重复登录操作就会发现取出的是 ROT13 转码后的z0ol——与登录表单原文不匹配根因水落石出。修复方法是在UserServiceImpl.findByLogin中对密码同样做一次 ROT13 转码。由于代码是挂载卷改完重新构建部署后刷新页面即可登录成功IntelliJ 调试 Java 容器Remote JVM Debug 配置详解如果你更习惯 IntelliJ流程几乎一致核心差异在于调试配置的入口导入项目Check out from Version Control克隆仓库后选择Import project from external model Maven勾选递归查找并指定 JDK 完成导入构建在右侧 Maven 面板的 Lifecycle 树中右键clean和install分别创建运行配置依次执行即可配置远程调试Run Edit Configurations添加一个Remote JVM Debug配置名称随意如docker tomcat端口填 8000与 Eclipse 的 JPDA 端口保持一致连上容器Run Debug...选择刚创建的远程配置Debugger 控制台即出现 Tomcat 连接。之后同样在User.setPassword处打断点、注册Moby用户Variables 面板会实时显示断点处的变量取值定位到getPassword返回转码值z0ol后按教程 IntelliJ-README.md 第 181 行附近的修复方案改findByLogin重新构建即可登录成功。VSCode 调试 Node.js 容器Attach 模式三步完成Node.js 容器调试更轻巧本机甚至不需要安装 Node.js运行时完全在容器里。示例应用位于 nodejs-debugging/app/是一个每 2 秒轮换一句名言的小页面同样内置了一个 off-by-one 的 bug。第 1 步启动带调试端口的容器docker-compose.yml 做了三件关键事用nodemon -L --inspect0.0.0.0:5858覆盖启动命令仅在开发时开启 V8 调试器生产镜像不带调试开关把当前目录挂载为/code本地改文件容器立即同步同时映射8000应用和5858调试器两个端口。执行docker-compose up后终端出现Debugger listening on port 5858即就绪。浏览器访问localhost:8000可以看到页面最后一句是空白——bug 复现了第 2 步配置 VSCode Attach 调试点击侧边栏的调试图标虫子形状通过齿轮图标选择 Node.js 模板生成.vscode/launch.json然后改写为Attach 配置{ name: Attach, type: node, request: attach, port: 5858, address: localhost, restart: true, localRoot: ${workspaceRoot}/, remoteRoot: /code }三个关键点request用attachIDE 只附加、不启动进程restart: true让调试器在 nodemon 重启应用后自动重连remoteRoot指向容器内代码路径/code解决宿主机与容器路径不一致的问题。选中该配置点击运行按钮VSCode 即附加到容器内的 Node 进程。第 3 步断点命中与热修复验证在app.js中lineIndex 1那一行点击行号左侧设置断点刷新浏览器VSCode 会在 2 秒内跳回前台并停在断点处。每次断下时展开 VARIABLES 面板的 Closure 区域可以看到lineIndex累加到了 4数组长度而正确行为应在到 3 后归零——典型的 off-by-one 错误把判断条件里的改成并保存奇迹发生了Docker 感知文件变化 → nodemon 自动重启 → VSCode 检测到调试器断开后自动重连全程无需手动干预。刷新浏览器空白消息消失名言完美循环 三大 IDE 容器调试配置速查表对比项EclipseIntelliJVSCode调试机制Remote Java Application (JPDA)Remote JVM DebugNode Attach (V8 Inspect)调试端口800080005858代码同步挂载卷 重新构建挂载卷 重新构建挂载卷 nodemon 热重启本机依赖JDK MavenJDK Maven无需安装 Node.js适用语言JavaJavaJavaScript / TypeScript新手避坑清单❌ 忘了映射调试端口——IDE 连接超时几乎都是这个原因❌remoteRoot与容器内实际代码路径不一致——断点全部变黄❌ 生产环境遗留调试参数——--inspect与 JPDA 仅供开发使用上线前务必关闭✅ 断点黄色不命中时先确认 IDE 里加载的源码与容器内运行的 class/文件版本一致。参考资料与延伸阅读 Java 容器调试总览java-debugging/README.md Node.js 容器调试总览nodejs-debugging/README.md Java 调试用 Tomcat 镜像定义registration-webserver/Dockerfile Node 应用 Compose 编排nodejs-debugging/app/docker-compose.yml NetBeans 同样支持该 Java 调试流程NetBeans-README.md按上面的步骤配置一次后你获得的是一套可复用的容器开发标准姿势本地写代码、容器跑运行时、IDE 远程断点——这正是 Docker 开发者体验的核心价值。创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
