goland本身不启动http服务，pprof需代码显式调用http.listenandserve（如go http.listenandserve("0.0.0.0:6060", nil)）才生效；仅import _ "net/http/pprof"而无服务监听则/debug/pprof/返回404。
GoLand 启动配置里没开 HTTP server，pprof 就不会监听
GoLand 本身不启动任何服务，它只是调用 go run 或 dlv 执行你的 main 函数。如果你的代码里没显式启动 http.ListenAndServe，哪怕 import 了 _ "net/http/pprof"，/debug/pprof/ 也根本不存在——浏览器访问直接 404。
常见错误是只写了 import，却漏掉启动语句：
- ❌ 错误写法：
import _ "net/http/pprof"+ 没有http.ListenAndServe - ✅ 正确写法：在
main()里加go http.ListenAndServe("0.0.0.0:6060", nil)（注意加go避免阻塞） - ⚠️ 注意地址：别用
"127.0.0.1:6060"，GoLand 调试时可能走容器或远程环境，"0.0.0.0:6060"更可靠
GoLand 的 Run Configuration 必须暴露端口并允许外部连接
即使代码里写了 ListenAndServe，GoLand 默认的 Run Configuration 可能限制网络访问。你需要手动检查三项：
- 确认「Run → Edit Configurations…」里勾选了
Allow parallel run（避免调试时端口被占） - 在「Go tool arguments」或「Program arguments」里不要加干扰参数（比如
-gcflags导致 pprof handler 注册失败） - 如果用 Docker 或 WSL，确保 GoLand 的「Build and run settings」中启用了端口映射，或改用 host network 模式
验证方式：启动后，在终端执行 curl -v http://localhost:6060/debug/pprof/，返回 200 且含 HTML 即成功。
用 Gin/Echo 等框架时，/debug/pprof 路由不会自动生效
GoLand 运行的是你写的完整服务，但 net/http/pprof 的 handler 默认注册在 http.DefaultServeMux，而 Gin/Echo 使用自己的路由树，/debug/pprof/ 请求根本进不到默认 mux。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
必须显式转发或注册：
- 对 Gin：用
r.Any("/debug/pprof/*pprofPath", gin.WrapH(http.DefaultServeMux)) - 对 Echo：用
e.GET("/debug/pprof/*", echo.WrapHandler(http.DefaultServeMux)) - 更稳妥：自己注册关键路径，比如
e.GET("/debug/pprof/", func(c echo.Context) error { return c.String(200, "ok") })再加pprof.Index处理逻辑
别依赖 import _ "net/http/pprof" 的 init 自动注册——它只对 http.DefaultServeMux 生效，且容易被框架覆盖。
调试时 pprof 数据为空？不是 GoLand 问题，是采样时机不对
在 GoLand 里打断点、单步执行时，goroutine 基本处于暂停或空闲状态，/debug/pprof/profile 抓不到 CPU 样本，/debug/pprof/heap 也可能因 GC 未触发而显示不准。
实操要点：
- CPU profile 必须在服务「持续运行且有真实负载」时采集：启动后先发几个请求（如
curl http://localhost:8080/health），再立刻调curl "http://localhost:6060/debug/pprof/profile?seconds=15" - 内存 profile 要等 GC 发生后才有意义：可在代码里加
runtime.GC()强制一次回收，再抓/debug/pprof/heap - 别在 GoLand 的 Debug 模式下等 pprof —— 切换到 Run 模式，或用
dlv --headless启动后再连 pprof
最易忽略的一点：GoLand 的 Terminal 和 Services 工具窗口默认不共享进程环境变量，GODEBUG 或 GOMAXPROCS 设错会导致采样线程调度异常，火焰图大量显示 idle。
