Echo中仅import _ "net/http/pprof"无效，因pprof仅向http.DefaultServeMux注册路由，而Echo使用自定义路由；必须手动挂载，如e.Group("/debug/pprof").Use(middleware.WrapHandler(http.DefaultServeMux))或显式注册各子路径。
直接在 Echo 里写 import _ "net/http/pprof" 不会生效，访问 /debug/pprof/ 一定返回 404——pprof 的路由只注册到了 http.DefaultServeMux，而 Echo 完全不用它。
Echo 中必须手动挂载 pprof 路由
不能依赖包导入自动生效。Echo 使用自定义路由机制，net/http/pprof 的 init() 函数虽然执行了，但注册目标是空的默认 mux，和你的 Echo 实例毫无关系。
- 最稳妥方式：用
e.Group("/debug/pprof").Use(middleware.WrapHandler(http.DefaultServeMux))，但要求你已引入github.com/labstack/echo/v4/middleware - 更可控方式：显式注册每个子路径，避免通配符或重定向问题：
e.GET("/debug/pprof", echo.WrapHandler(http.HandlerFunc(pprof.Index))) e.GET("/debug/pprof/heap", echo.WrapHandler(http.HandlerFunc(pprof.Heap))) e.GET("/debug/pprof/goroutine", echo.WrapHandler(http.HandlerFunc(pprof.Goroutine))) e.GET("/debug/pprof/profile", echo.WrapHandler(http.HandlerFunc(pprof.Profile))) e.GET("/debug/pprof/block", echo.WrapHandler(http.HandlerFunc(pprof.Block))) - 注意：
echo.WrapHandler是必须的，不能直接传http.HandlerFunc(pprof.XXX)给e.GET，否则 Echo 无法正确处理响应头和状态码
采集 CPU profile 时全是 runtime.futex 怎么办
这不是数据错误，而是采样机制的天然限制：CPU profile 基于 SIGPROF 信号，只捕获 goroutine 正在执行用户代码的瞬间；一旦阻塞在 channel、锁、syscall 或 GC，就“看不见”。
Echo框架 5.1.0
下载
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
- 先确认业务是否真在跑：压测 QPS 稳定至少 1–2 分钟后再采样，避免冷启动抖动干扰
- 采样时长必须 ≥30 秒：
go tool pprof http://localhost:8080/debug/pprof/profile?seconds=30，低于 15 秒基本不可信 - 如果
top仍无业务函数，立刻切到/debug/pprof/goroutine?debug=2，搜索chan receive、semacquire、select，重复出现的行号（如client.go:72）往往是泄漏或阻塞源头 - 火焰图里大量扁平分支指向
log.Printf或time.Now()？别优化算法，优先删日志或改用带条件判断的zap.Sugar().Debugw
heap profile 显示内存不涨，但服务还是 OOM
/debug/pprof/heap 默认返回的是 inuse_space（当前存活对象），不是分配总量。高频分配+快速 GC 的代码，在 inuse 里完全看不到，但会拖垮 GC 频率，最终耗尽内存。
立即学习“go语言免费学习笔记（深入）”；
- 要查分配热点，必须用
/debug/pprof/allocs：curl -o allocs.pprof http://localhost:8080/debug/pprof/allocs - 想看真实驻留内存，加
?gc=1强制 GC 后再采：/debug/pprof/heap?gc=1（Go 1.19+ 支持） - 生产环境务必限制访问：用中间件校验 IP 段，或加 Basic Auth；堆 dump 可能泄露结构体字段名和敏感字段值
- 连续抓两次
heap?gc=1&next=1（next=1表示只返回比上次更大的样本），观察inuse_space是否持续增长
最容易被忽略的一点：Echo 的 WriteTimeout 默认是 30 秒，而 /debug/pprof/profile?seconds=30 本身就要跑满 30 秒——若没调大超时，请求会提前中断，profile 数据截断失效。
