GoLand调试器基于Delve，需直接访问进程PID和内存，而Docker容器隔离导致无法直连；pprof仅通过HTTP拉取采样数据，不暂停程序，二者机制不同，故GoLand不能直接用于pprof分析。
GoLand 本身不支持直接 attach 到 Docker 容器里的 Go 进程做 pprof 调试，必须靠容器内暴露 HTTP 接口 + GoLand 外部调用 go tool pprof 完成分析。 否则你会卡在“找不到进程”或“无法解析符号”上。
为什么 GoLand 的 Debugger 不能直接用于 pprof 分析
GoLand 的调试器基于 Delve，它需要宿主机能直接访问目标进程的 PID 和内存空间；而 Docker 容器是隔离的，Delve agent 若未提前注入并暴露调试端口（如 :2345），GoLand 就连不上。pprof 不是调试器——它不暂停程序、不读寄存器，只靠 HTTP 拉取运行时采样数据。混用 Delve 和 pprof 是常见误解。
- GoLand 的 “Attach to Process” 功能在容器场景下基本不可用（除非你用
docker exec -it container-name /bin/sh手动启动 delved） - pprof 的核心依赖是：容器内服务监听了可访问的
:6060（或其它端口），且路由/debug/pprof/已注册成功 - GoLand 只能作为终端外壳来执行
go tool pprof命令，不能替代它
容器内启用 pprof 的最小可靠配置
别信“只要 import _ "net/http/pprof" 就行”。Docker 环境下，三个点必须同时满足：
- HTTP server 必须显式监听
0.0.0.0:6060（不是127.0.0.1:6060），否则宿主机 curl 不通 - 确保
net/http/pprof是下划线导入：import _ "net/http/pprof"，且该包在 main 包中被加载（不能放在子包里 init） - 启动 pprof server 的 goroutine 不能被主逻辑阻塞——推荐用
go http.ListenAndServe(":6060", nil)，不要等业务逻辑结束
示例片段（放在 main() 开头）：
go func() {
log.Println("Starting pprof server on :6060")
log.Fatal(http.ListenAndServe("0.0.0.0:6060", nil))
}()
GoLand 中如何真正用上 pprof 数据
你在 GoLand 里能做的，就是开 Terminal，手动运行 go tool pprof 并传对参数。关键陷阱在于二进制文件路径和采样源的匹配：
- 容器内编译的二进制（如
/app/myserver）必须和宿主机上的副本完全一致（含调试信息），否则top全是runtime.mcall - 正确命令格式：
go tool pprof ./myserver http://localhost:6060/debug/pprof/profile?seconds=30（注意：先写本地二进制路径，再写远程 URL） - 如果容器端口映射是
-p 6060:6060，URL 就用http://localhost:6060/...；如果是 Kubernetes，得用port-forward中转 - 内存泄漏排查务必加
?gc=1：http://localhost:6060/debug/pprof/heap?gc=1，否则看到的是分配总量，不是存活对象
Dockerfile 和运行时必须检查的细节
很多团队 build 出来的镜像跑 pprof 是空的，问题往往藏在构建阶段：
- 禁止使用
CGO_ENABLED=0+UPX或其他 strip 工具——它们会删掉 DWARF 符号表，go tool pprof就无法还原函数名 - Dockerfile 中应显式保留调试信息：
go build -ldflags="-s -w" -o myserver .里的-s -w要慎用（-s 删符号表，-w 删 DWARF） - 运行容器时，确保没加
--read-only或限制网络——pprof 需要 outbound DNS（若用了域名）和 inbound HTTP 访问 - 用
docker inspect <container>确认NetworkSettings.Ports确实映射了 6060 端口
最易被忽略的一点：pprof 的 /debug/pprof/goroutine?debug=2 返回的是纯文本栈，但如果你的容器日志被重定向或截断，可能看不到完整 goroutine 列表——建议先 curl 验证原始响应体是否完整。
