根本原因是Go服务监听地址错误，必须监听0.0.0.0:8080而非127.0.0.1或localhost；GoLand端口映射仅负责-p转发，不干预容器内进程绑定行为，若程序自身拒绝外部连接，则调试必失败。
GoLand 里 debug 微服务容器组时，端口转发不生效的根源
根本原因不是 GoLand 配置错了，而是容器内 Go 程序没监听 0.0.0.0:8080，只绑了 127.0.0.1:8080 或 localhost:8080。GoLand 的 “Docker Debug” 配置只是把宿主机端口映射进容器，它不干预容器内进程监听行为 —— 如果 Go 服务自己拒绝外部连接，再好的 IDE 转发也白搭。
常见错误现象：docker ps 显示容器在运行，curl http://localhost:8080 返回 Connection refused，GoLand Debugger 卡在 “Waiting for process to connect...”。
- 检查 Go 代码中
http.ListenAndServe的地址参数：必须是"0.0.0.0:8080"，不能是"127.0.0.1:8080"或":8080"（后者在某些系统上等价于127.0.0.1） - 确认 Dockerfile 中没写死监听地址：比如
ENV ADDR=localhost:8080就会覆盖环境变量传入值 - GoLand 的 Run Configuration → Docker → Port mappings 只负责
-p行为，它不会改容器内程序行为；真正起作用的是你传给ListenAndServe的地址
GoLand 中配置多端口映射（API + metrics + pprof）的实操要点
GoLand 支持在单个 Docker 运行配置中添加多个端口映射，但容易忽略顺序和协议差异 —— 尤其当微服务同时暴露 HTTP API、Prometheus metrics 和 pprof 调试端点时。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 在 Run Configuration → Docker → Port mappings 中，逐条添加：
-
8080:8080（HTTP API） -
9090:9090（metrics，假设你的 /metrics 路由跑在 9090） -
6060:6060（pprof，需确保 Go 程序显式启动net/http/pprof并监听该端口）
-
- 不要依赖
EXPOSE指令：Dockerfile 里的EXPOSE 8080对 GoLand 映射无任何影响，它只是元信息 - 若某端口（如
6060）仅用于本地调试，建议加127.0.0.1:前缀：填127.0.0.1:6060:6060，避免意外暴露到局域网 - GoLand 不自动识别
ports字段：即使你有docker-compose.yml，GoLand 的 Docker 运行配置仍需手动同步端口，不会读取 compose 文件
用 docker-compose.yml 配合 GoLand 启动容器组时的端口陷阱
当你在 GoLand 中选择 “Docker Compose” 作为运行配置类型时，端口映射逻辑看似统一，但实际执行仍分两层：compose 解析 ports → Docker daemon 执行 -p。中间一旦环境变量没透传，就全盘失效。
-
docker-compose.yml中的ports字段只控制映射，不决定容器内监听地址；真正决定监听行为的是传给http.ListenAndServe的地址 - 确保
environment正确注入：比如写- ADDR=0.0.0.0:8080，而不是- PORT=8080（后者需要 Go 代码自己拼接":" + os.Getenv("PORT")，易出错） - GoLand 默认不加载
.env文件：如果 compose 里用了${API_PORT}，得在 Run Configuration → Environment variables 里手动补上，否则映射成空 - 调试 metrics 或 pprof 时，别只 curl 宿主机端口：先进容器执行
ss -tln | grep :9090，确认服务真在监听，再查映射是否生效
GoLand 调试容器内 Go 微服务时，pprof 和健康检查端口不通的排查路径
pprof（/debug/pprof）和健康检查（/health）端口不通，90% 是因为 Go 程序启动后没真正监听对应端口，而非 GoLand 配置问题。
- 健康检查端点必须走同一监听地址：如果 API 监听
0.0.0.0:8080，那么/health也要注册在同一个http.ServeMux上，不能另起一个http.Server绑127.0.0.1:8081 - pprof 需显式挂载：默认不自动暴露，得在代码里加
import _ "net/http/pprof"，并确保它挂到了正在监听的http.DefaultServeMux或自定义 mux 上 - GoLand 的 “Attach to Process” 模式对容器内进程无效：它只支持 attach 到宿主机上的本地进程；容器内调试必须靠端口映射 + 远程调试（dlv-dap）或日志+curl 排查
- 最简验证法：容器启动后，立刻执行
docker exec -it <container> wget -qO- http://localhost:8080/health—— 若失败，说明问题在 Go 程序自身，跟 GoLand 无关
GoLand 的端口配置本身很直白，真正的复杂性藏在 Go 程序监听逻辑与 Docker 网络模型的耦合里：你写的每一行 ListenAndServe，都得和 docker run -p、docker-compose ports、容器网络模式（bridge vs host）对齐，漏掉任一环，端口就“消失”。
