3. pprof 工具全景：CPU、内存、goroutine、阻塞与互斥锁分析能力

pprof 是 Go 语言内置的性能分析工具，能够采集运行时多种维度的采样数据，帮助开发者定位性能瓶颈。本章将系统介绍 pprof 的五大分析能力，并重点聚焦 CPU Profiling 的原理与使用方式。

3.1 pprof 五大分析能力概览

pprof 通过 runtime/pprof 和 net/http/pprof 包暴露采样接口，支持以下五种分析类型：

3.2 CPU Profiling 核心原理

CPU Profiling 基于 定时中断采样 机制：

• Go 运行时启动一个独立的采样线程，以固定频率（默认 100 Hz，即每 10 ms 一次）向所有正在运行的线程发送 SIGPROF 信号。
• 信号处理函数捕获当前线程的调用栈（stack trace），记录程序计数器（PC）地址。
• 采样结束后，pprof 工具将 PC 地址解析为函数名、文件名和行号，生成调用关系图。
• 采样频率越高，统计精度越高，但运行时开销也越大。100 Hz 在大多数生产环境中可接受。

3.3 CPU Profiling 工作流程

下图展示了 CPU Profiling 从采样到可视化的完整链路：

3.4 启动 CPU Profiling 的两种方式

方式一：代码埋点（适用于短时任务）

import (
    "os"
    "runtime/pprof"
)

func main() {
    f, _ := os.Create("cpu.pprof")
    pprof.StartCPUProfile(f)
    defer pprof.StopCPUProfile()

    // 业务逻辑
    runService()
}

方式二：HTTP 接口（适用于长运行服务）

import (
    _ "net/http/pprof"
    "net/http"
)

func main() {
    // 默认在 /debug/pprof/profile 暴露 CPU 采样
    http.ListenAndServe(":6060", nil)
}

// 采集命令：
// go tool pprof http://localhost:6060/debug/pprof/profile?seconds=30

3.5 可视化分析命令

采集到 pprof 文件后，使用 go tool pprof 进入交互式分析：

# 启动交互式终端
go tool pprof cpu.pprof

# 常用命令
top10        # 查看 CPU 耗时前 10 的函数
list main    # 查看 main 包内函数的源码级耗时分布
web          # 生成 SVG 火焰图（需安装 graphviz）
peek         # 查看调用链上下游

火焰图是 CPU Profiling 最直观的可视化形式，每个矩形代表一个函数，宽度表示 CPU 耗时占比：

3.6 其他分析能力速览

除 CPU 外，pprof 的其他分析能力在中间件链路优化中同样重要：

• 内存分析： 使用 /debug/pprof/heap 采集，关注 alloc_objects 和 alloc_space 指标，排查中间件缓存或连接池的内存泄漏。
• Goroutine 分析： 使用 /debug/pprof/goroutine 采集，查看 goroutine 数量是否异常增长，定位协程泄漏点。
• 阻塞分析： 需先调用 runtime.SetBlockProfileRate(1) 开启，分析 channel 或锁导致的 goroutine 阻塞。
• 互斥锁分析： 需先调用 runtime.SetMutexProfileFraction(1) 开启，定位锁竞争激烈的热点。