必须手动挂载pprof路由，否则返回404；因net/http/pprof仅向http.DefaultServeMux注册，而Fiber完全隔离该mux，即使导入包也无效，须通过app.Get("/debug/pprof/*pprof", ...)桥接DefaultServeMux。
必须手动挂载 /debug/pprof 路由，否则访问直接 404；heap 采样不加 ?gc=1 会看到积压对象而非真实泄漏点。
为什么 Fiber 中 /debug/pprof/ 返回 404
net/http/pprof 的 init() 函数只向 http.DefaultServeMux 注册路由，而 Fiber 完全不使用它——即使你写了 import _ "net/http/pprof"，也仅是初始化了空的默认 mux，Fiber 的 fiber.App 实例仍完全隔离。
常见错误：以为导入就生效，结果 curl http://localhost:3000/debug/pprof/ 返回 404。
- 必须在
app.Get("/debug/pprof/*pprof", ...)中桥接http.DefaultServeMux - 该路由必须注册在所有中间件（如 JWT、CORS、Recovery）之后，否则鉴权逻辑会拦截请求
- 监听地址不能只绑
127.0.0.1:3000；压测机需访问时，得用0.0.0.0:3000
怎么正确挂载 pprof 路由（Fiber v2.50+）
推荐写法（简洁且兼容）：
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
import _ "net/http/pprof"
// 在 app 初始化后、启动前插入
app.Get("/debug/pprof/*pprof", func(c *fiber.Ctx) error {
c.Set("Content-Type", "text/plain; charset=utf-8")
http.DefaultServeMux.ServeHTTP(c.Response().Writer, c.Request().Request)
return nil
})
注意：*pprof 是通配符，不可省略或写成 **pprof；末尾斜杠也不可省，否则 /debug/pprof/heap 重定向会失败。
- 验证是否成功：启动后执行
curl http://localhost:3000/debug/pprof/，应返回 HTML 页面 - 不要用
c.Redirect()或c.Next()桥接——它们无法传递原始*http.Request - 若用 Fiber v3，API 不变，但需确认未启用
StrictRouting导致路径匹配失败
/debug/pprof/heap 必须加 ?gc=1
Fiber 高并发下对象分配快、GC 滞后。/debug/pprof/heap 默认返回的是「当前存活对象」（inuse_space），但若未强制 GC，采样到的很可能是上一轮未回收的积压结构体，比如残留的 map[string]interface{} 实例，和当前业务无关。
- 正确采集命令：
curl "http://localhost:3000/debug/pprof/heap?gc=1"（Go 1.19+ 支持） - 不要依赖先调
runtime.GC()再curl——GC 异步，调用后立即 fetch 可能为空或中断 - 更稳妥流程：压测稳定运行 30 秒 → 发送
?gc=1请求 → 等待 1–2 秒再分析 - 用
go tool pprof -http=:8081 http://localhost:3000/debug/pprof/heap?gc=1打开 Web 界面，默认看inuse_space；需查累计分配量，顶部 dropdown 切换为alloc_space
goroutine profile 易被中间件闭包污染
Fiber 中间件（尤其是日志、Recovery、JWT）常捕获上下文、持有 request body 引用或创建匿名函数闭包，导致 /debug/pprof/goroutine?debug=2 输出中大量出现 http.HandlerFunc、func1 等占位符，掩盖真正阻塞点（如 DB 查询、channel receive）。
- 排查泄漏时优先用
curl "http://localhost:3000/debug/pprof/goroutine?debug=2"，全文搜索chan receive、semacquire、select - 若发现某行号（如
client.go:72）重复高频出现，大概率是未关闭 channel 或缺少default分支的for-select - 临时注释掉非必要中间件再采样，对比 goroutine 栈差异，快速定位污染源
- 生产环境务必加 Basic Auth 鉴权，避免堆 dump 泄露敏感字段
最易忽略的点：pprof 数据本身无符号表，go tool pprof 分析时若没传原始二进制文件（如 go tool pprof ./myserver http://...），top 里全是 runtime.mcall 或十六进制地址——这和 Fiber 无关，是 Go 工具链通用限制。
