构建可调试微服务需使用多阶段Docker镜像，保留调试工具并挂载源码；通过EXPOSE调试端口（如2345），结合IDE远程调试配置实现断点调试；利用docker logs与exec排查问题，并用Docker Compose管理多服务依赖，提升调试效率。
在容器中构建和调试微服务是现代 Linux 开发中的常见场景。关键在于合理使用 Docker 构建运行环境，并通过工具链实现高效调试。下面从构建到调试，给出实用方法。
构建可调试的微服务容器镜像
开发阶段的镜像需要包含调试工具和源码，不能追求极致精简。
- 使用多阶段构建，开发镜像保留编译依赖和调试工具（如 gdb、curl、netstat）
- 挂载源码目录而非 COPY，便于代码变更即时生效
- 暴露调试端口（如 Golang 的 delve 使用 2345，Java 的 jdwp 使用 5005）
- 设置 ENTRYPOINT 为可调试启动方式，例如启动时暂停等待调试器连接
示例 Dockerfile 片段：
FROM golang:1.21 as builder WORKDIR /app COPY . . RUN go build -o main . FROM golang:1.21 as debug WORKDIR /app COPY --from=builder /app/main . COPY --from=builder /app/src ./src RUN go install github.com/go-delve/delve/cmd/dlv@latest EXPOSE 2345 ENTRYPOINT ["dlv", "exec", "./main", "--headless", "--listen=:2345", "--accept-multiclient"]
使用 IDE 远程调试容器内服务
主流 IDE 都支持远程调试协议，结合端口映射即可接入容器进程。
- 运行容器时映射调试端口：docker run -p 2345:2345 your-debug-image
- 在 VS Code 中配置 launch.json，类型选 remote，地址指向 localhost:2345
- GoLand 或 IntelliJ 可添加 Remote JVM 或 Go Remote 配置，填写主机和端口
- 确保本地源码路径与容器内路径一致，否则断点无法命中
利用日志和 shell 排查问题
并非所有问题都需要打断点，快速查看日志和进入容器排查更高效。
- 使用 docker logs -f 查看实时输出，结合结构化日志（如 JSON 格式）方便过滤
- docker exec -it <container> sh 进入容器，检查文件、环境变量、网络连通性
- 在代码中加入调试开关，开启时打印详细 trace 信息
- 用 curl 或 wget 测试服务接口是否正常响应
结合 Docker Compose 管理多服务依赖
微服务往往依赖数据库、消息队列等，Docker Compose 可一键启动完整环境。
- 编写 docker-compose.yml 定义服务网络、卷、端口映射和依赖关系
- 为开发环境单独定义一个 override 文件，启用调试模式
- 使用 volumes 将本地代码挂载进容器，修改即生效
- 通过 service 名称访问其他容器，模拟真实微服务调用
调试时执行：docker-compose -f docker-compose.yml -f docker-compose.debug.yml up，启动带调试支持的服务组。
基本上就这些。核心是区分构建与调试需求，灵活利用容器特性配合开发工具，让微服务在隔离环境中也能像本地一样轻松排错。
