Kratos 启动后访问 /debug/pprof/ 返回 404，是因为其默认使用自定义 http.ServeMux，而 net/http/pprof 的 init() 函数仅向 http.DefaultServeMux 注册路由，仅导入 _ "net/http/pprof" 不生效，必须手动将 pprof handler 挂载到 Kratos 的 HTTP server mux 上。
Kratos 框架默认不开启 pprof，必须显式注册 HTTP 路由并确保监听地址安全；否则访问 /debug/pprof/ 会 404 或暴露敏感指标。
为什么 Kratos 启动后访问 /debug/pprof 返回 404
Kratos 默认使用自定义 http.ServeMux（非 http.DefaultServeMux），而 net/http/pprof 的 init() 函数只向 DefaultServeMux 注册路由。仅导入 _ "net/http/pprof" 不生效。
- 必须手动调用
pprof.Handler("profile").ServeHTTP或pprof.Index挂载到 Kratos 的http.Servermux 上 - 若用
kratos/pkg/net/http（旧版）或kratos/pkg/conf/paladin配置 HTTP server，需在http.NewServer构建前完成挂载 - 检查是否误将 pprof 挂在了 gRPC server 上——它只支持 HTTP 接口
如何在 Kratos 中正确启用 pprof HTTP 接口
以 Kratos v2.7+（基于 go-kratos/kratos）为例，在 cmd/server/main.go 的 HTTP server 初始化阶段插入注册逻辑：
import (
_ "net/http/pprof"
"net/http/pprof"
)
// 在 http.NewServer(...) 之前
mux := http.NewServeMux()
mux.Handle("/debug/pprof/", http.HandlerFunc(pprof.Index))
mux.Handle("/debug/pprof/cmdline", http.HandlerFunc(pprof.Cmdline))
mux.Handle("/debug/pprof/profile", http.HandlerFunc(pprof.Profile))
mux.Handle("/debug/pprof/symbol", http.HandlerFunc(pprof.Symbol))
mux.Handle("/debug/pprof/trace", http.HandlerFunc(pprof.Trace))
s := http.NewServer(
http.Address(":8000"),
http.Handler(mux),
)
- 务必保留路径末尾的
/（如/debug/pprof/），否则子路由（如/debug/pprof/heap）无法匹配 - 生产环境必须加访问控制：用中间件限制 IP 段，或前置反向代理做 Basic Auth
- 避免监听
0.0.0.0:6060；推荐绑定127.0.0.1:6060或内网地址
抓取 CPU profile 时为什么看不到业务函数
访问 http://localhost:8000/debug/pprof/profile?seconds=30 后生成的 cpu.pprof 里全是 runtime.futex、runtime.epollwait，说明采样期间程序未处于 CPU 密集态。
- 确认压测已稳定：QPS 达到目标值并持续 ≥ 1 分钟后再触发采样
- 别用浏览器直接点
/debug/pprof/页面里的 profile 链接——它固定采 30 秒且无法调整参数 - 改用命令行延长采样：
curl -o cpu.pprof "http://localhost:8000/debug/pprof/profile?seconds=60" - 若仍无业务函数，可能是瓶颈不在 CPU：改查
/debug/pprof/goroutine?debug=2看协程阻塞，或/debug/pprof/block看锁竞争
分析 heap profile 时 inuse_space 不涨，但内存持续上涨
Kratos 服务 RSS 内存不断上升，但 /debug/pprof/heap 显示 inuse_space 平稳，说明问题不在长期驻留对象，而在高频短生命周期分配。
- 先看
/debug/pprof/allocs：它反映累计分配量，持续飙升意味着 GC 压力大或存在隐式逃逸 - 用
go tool pprof -sample_index=alloc_space heap.pprof切换视角，再top查分配热点 - Kratos 的 middleware、transport.JSON 编解码、log.Zap 字段构造都容易触发高频小对象分配，重点关注这些链路
- 注意：Kratos v2.6+ 默认启用
jsoniter，若切换回encoding/json可能加剧逃逸，需对比验证
pprof 在 Kratos 里不是“开个包就完事”的功能，它依赖路由挂载时机、采样窗口选择和指标解读维度三者配合；漏掉任意一环，看到的都是调度器或 runtime 的假象。
