go程序cpu profiling失败八成因profile文件为空，主因是采样未真正运行：pprof.startcpuprofile启动后stop未执行、采样时间不足15秒、文件未显式f.close()导致未落盘。
Go 程序 CPU profiling 失败，八成是 profile 文件为空 —— 根本原因不是工具不会用，而是采样没真正跑起来。
为什么 cpu.prof 文件总是空的？
你执行 go tool pprof cpu.prof 却看到 index out of range panic 或 “no samples” 提示，说明文件里没数据。这不是 bug，而是以下任一情况发生了：
-
pprof.StartCPUProfile(f)启动了，但pprof.StopCPUProfile()没执行到：程序 panic、os.Exit()、main 提前返回，defer被跳过 - 采样时间太短：CPU profiling 需要 ≥15 秒活跃运行（且有真实计算/调用），CLI 工具若无阻塞逻辑（比如没
time.Sleep或 HTTP server），采样器根本来不及抓栈帧 - 文件未 flush 落盘：仅
os.Create()+pprof.StartCPUProfile(f)不够，f.Close()必须显式调用，否则 OS 缓冲区可能不写入磁盘
pprof.StartCPUProfile 和 pprof.StopCPUProfile 怎么配对才安全？
别依赖 defer f.Close() 在程序退出时自动关文件 —— 它和 pprof.StopCPUProfile() 的执行顺序不可控，且 panic 时会失效。正确做法是把两者包进同一个 defer 函数里：
func main() {
f, err := os.Create("cpu.prof")
if err != nil {
log.Fatal(err)
}
if err := pprof.StartCPUProfile(f); err != nil {
log.Fatal(err)
}
defer func() {
pprof.StopCPUProfile() // 必须先停采样
f.Close() // 再关文件，确保 flush
}()
<pre class="brush:php;toolbar:false;">// 这里放你要分析的业务代码，比如：
http.ListenAndServe(":8080", nil) // 长期服务
// 或
time.Sleep(20 * time.Second) // CLI 工具必须等够时间}
注意：pprof.StartCPUProfile 返回 error 时不能忽略；StopCPUProfile 可重复调用，但多次 Start 会 panic。
HTTP 服务该用 net/http/pprof 还是 runtime/pprof？
生产服务优先用 net/http/pprof，它暴露 /debug/pprof/profile?seconds=30 接口，支持按需、远程、指定时长采样，不改代码也能动态触发：
- 导入
_ "net/http/pprof"即自动注册路由（注意下划线） - 启动独立 pprof server（如
localhost:6060），避免和主业务端口耦合 - 采集命令：
go tool pprof http://localhost:6060/debug/pprof/profile\?seconds=30 - 别在生产环境直接暴露
/debug/pprof到公网 —— 加反向代理鉴权或只监听 localhost
而 runtime/pprof 更适合离线 CLI 工具、测试脚本或无法开 HTTP 端口的场景，但必须手动控制生命周期和文件 IO。
用 go tool pprof 分析时容易忽略的关键点
拿到 cpu.prof 后，别急着 top —— 先确认符号是否解析成功：
- 编译时禁用优化会显著提升可读性：
go build -gcflags="-N -l" -
go tool pprof默认不加载源码，list命令只能看到函数名；加-http=启服务后点“Source”才能跳转行号 - 火焰图生成依赖
go-torch或pprof自带 SVG：go tool pprof -svg cpu.prof > flame.svg，但需确保系统装了dot（graphviz） - 如果
top显示全是runtime.*或syscall.Syscall，说明采样期间程序大部分时间在等待（I/O、锁、sleep），真热点可能藏在下面一层 —— 试试top -cum看累积调用链
最常被跳过的动作：采样前没让程序进入真实负载状态，或者采样结束后没等 StopCPUProfile 和 f.Close() 完全执行完就杀进程 —— 这会导致文件为空，一切分析归零。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
