Go pprof 在线诊断：CPU、内存与 goroutine 问题怎么定位

线上 CPU 飙升、内存上涨、goroutine 数持续增加时，日志往往只能看到结果。pprof 可以直接采样运行时状态，是 Go 故障排查的核心证据。

解决方案思路

在受保护的调试端口启用 net/http/pprof，CPU 问题采 profile，内存问题看 heap，泄漏问题看 goroutine dump。采样窗口要和告警时间对齐，拿到 profile 后先看 top 和火焰图，再决定修复点。

核心代码示例

import _ "net/http/pprof"

go func() {
    http.ListenAndServe("127.0.0.1:6060", nil)
}()
// go tool pprof http://127.0.0.1:6060/debug/pprof/profile?seconds=30

运行逻辑

排查顺序可以是：确认症状指标，短时采样，读取 top 或火焰图，定位函数调用链，修改后用同口径压测和 profile 对比。

重点观察指标

• CPU profile 热点函数占比
• heap inuse_space、alloc_space 和对象来源
• goroutine dump 中相同阻塞栈数量

常见误区

• pprof 端口暴露到公网
• 在低流量窗口采样导致热点不真实
• 只看一次 profile，不做修复前后对比

参考方案

• net/http/pprof 官方文档
• Go Diagnostics 文档

落地检查

• 字段、指标和 Span 名称要稳定，便于长期聚合。
• 上线前先在灰度环境验证采集成本和数据量。
• 告警必须能指向 owner、排查入口和回滚方案。