应直接使用 gin-contrib/pprof，因其封装 net/http/pprof 所有 handler 并适配 gin 路由，避免手动注册导致的路径映射错误、多端口暴露、endpoint 遗漏及超时中断等问题。
直接用 gin-contrib/pprof，别自己手写路由注册或起独立 HTTP 服务——它封装了标准库 net/http/pprof 的所有 handler，并适配 Gin 的路由机制，省去路径映射、超时控制、goroutine 安全等隐性坑。
为什么不用 net/http/pprof 直接导入
很多人看到官方文档说 “导入 _ "net/http/pprof" 就能开 pprof”，就照搬进 Gin 项目，结果发现 /debug/pprof 路由根本访问不到，或者返回 404。这是因为：net/http/pprof 默认注册到 http.DefaultServeMux，而 Gin 用的是自己的 gin.Engine 路由树，两者不互通。
- 强行共用
DefaultServeMux需额外起一个http.ListenAndServe(":6060", nil)服务，多端口暴露，生产环境权限难收敛 - 手动把每个 pprof handler（如
pprof.Index、pprof.Profile）转成 GinHandlerFunc很容易漏掉/debug/pprof/cmdline或/debug/pprof/symbol这类冷门但调试关键的 endpoint - CPU profile 默认 30 秒采集，若 Gin 的
WriteTimeout小于该值（比如设了 10s），请求会提前中断，profile 文件损坏
gin-contrib/pprof.Register 怎么用才不出错
最简集成只需一行，但几个参数和时机决定是否真正可用：
- 必须在
router.Run()之前调用pprof.Register(router)，否则路由未生效 - 默认路径是
/debug/pprof，访问http://localhost:8080/debug/pprof应返回 HTML 索引页；如果 404，请检查是否误写成pprof.Register(r)却没 import 包 - 想改路径前缀？传第二个参数：
pprof.Register(router, "admin/pprof")，此时 endpoint 变为/admin/pprof - 不要在中间件链里调用
pprof.Register—— 它注册的是全局路由，不是中间件
生产环境必须加访问控制
pprof 接口泄露 runtime 信息，包括堆栈、内存布局、甚至源码路径，公网暴露等于送攻击面。
- 用 Gin 的
Group+ 认证中间件是最小侵入方案，例如：debugGroup := router.Group("/debug", basicAuthMiddleware)，再调用pprof.RouteRegister(debugGroup, "pprof") - 避免用 IP 白名单做校验——K8s Service Mesh 或反向代理后，
c.ClientIP()常是内网地址，不可靠 - 不要只拦截
/debug/pprof主页，而放行/debug/pprof/heap或/debug/pprof/profile?seconds=60—— 后者才是真实数据出口，必须统一鉴权 - 某些 CI/CD 环境禁止加载
net/http/pprof，可加 build tag 控制：//go:build pprof，上线时用go build -tags="!pprof"排除
采集 CPU 和内存 profile 的实操要点
命令行工具 go tool pprof 调用看似简单，但参数错一位就拿不到有效数据：
- CPU 分析：运行
go tool pprof http://localhost:8080/debug/pprof/profile?seconds=30，注意?seconds=30是 query 参数，不是路径一部分；若省略，默认也是 30s，但显式写出更可控 - 内存分析：常用两个视角：
go tool pprof -inuse_space http://localhost:8080/debug/pprof/heap（常驻内存），go tool pprof -alloc_objects http://localhost:8080/debug/pprof/heap（临时分配对象数），别混淆-inuse_space和-alloc_space - goroutine 泄漏排查：先访问
/debug/pprof/goroutine?debug=2看完整堆栈，再对比/debug/pprof/goroutine（默认只显示 runnable/blocking 状态），确认是否有持续增长的 idle goroutine - 阻塞分析需前置设置：
runtime.SetBlockProfileRate(1)，否则/debug/pprof/block返回空；这个 rate 值越大采样越稀疏，线上建议设为 1，开发期可设 10
pprof 不是开箱即用的“性能开关”，它是 runtime 的快照接口——你得清楚每条 URL 返回什么、go tool pprof 的 flag 怎么组合、以及哪些数据需要提前开启采样率。漏掉任意一环，拿到的都可能是误导性结果。
