pprof需手动注册路由或调用StartServer，浏览器直接访问返回404；其数据为二进制格式，须用go tool pprof可视化；应避免使用DefaultServeMux，推荐独立mux并strip prefix；不同profile类型采集逻辑各异，需按需配置采样参数。
pprof 服务没暴露出来，浏览器打不开 /debug/pprof/
默认情况下，net/http/pprof 不会自动注册路由，它只是提供了一组 handler，需要你手动挂载。很多人直接 import 就以为能用，结果访问 http://localhost:8080/debug/pprof/ 返回 404。
- 必须显式调用
pprof.Register()（可选，仅用于自定义 profile）并用http.Handle()或mux.HandleFunc()挂载pprof.Handler("profile")等 handler - 最简方式是直接调用
pprof.StartServer()，它会自动监听指定地址并注册全部标准路由，比如：pprof.StartServer(":6060") - 如果用了自定义
http.ServeMux，得确保挂载路径是/debug/pprof/（注意末尾斜杠），否则子路径如/debug/pprof/goroutine会 404 - 生产环境别用
StartServer暴露在公网——它不带任何认证，所有 profile 数据（含堆、goroutine trace）都会被读取
浏览器点开 goroutine 或 heap 页面卡死 / 返回空页
这不是页面问题，而是 pprof 默认返回的是文本格式（plain text），浏览器无法渲染原始 profile 数据。你看到的“空白”其实是二进制或 base64 编码的采样数据，不是 HTML。
- 想在浏览器里看可视化图表，必须用
go tool pprof命令行工具配合 HTTP 服务，例如：go tool pprof http://localhost:6060/debug/pprof/heap，然后输入web启动本地图形界面 - 也可以加
-http=localhost:8081参数让 pprof 直接起一个带 Web UI 的服务：go tool pprof -http=:8081 http://localhost:6060/debug/pprof/profile - 注意：
profile是 CPU profile，采样需持续至少 30 秒；heap是内存快照，要触发 GC 才有变化，可先调用runtime.GC()再抓取 - 若提示
failed to fetch profile，检查目标服务是否真在运行、端口是否通、路径是否拼错（比如漏了/debug/pprof/前缀）
用 http.DefaultServeMux 注册 pprof 后，其他路由 404
因为 http.DefaultServeMux 是全局单例，一旦第三方库或你自己提前调用了 http.HandleFunc，就可能覆盖或干扰 pprof 的注册逻辑——尤其是当多个包都往 DefaultServeMux 上写时，顺序和冲突很难控制。
- 推荐始终使用独立的
http.ServeMux实例，避免污染全局状态：mux := http.NewServeMux(); mux.Handle("/debug/pprof/", http.StripPrefix("/debug/pprof/", pprof.Handler("index"))) -
http.StripPrefix很关键：pprof handler 内部期望路径以/开头，但浏览器请求的是/debug/pprof/，不 strip 就会找不到子资源 - 如果你用的是 Gin、Echo 等框架，别往
DefaultServeMux里塞 pprof，应通过框架中间件或自定义 handler 接入，比如 Gin 中用gin.WrapH(pprof.Handler("index"))
采样不到 goroutine 阻塞或内存泄漏？
pprof 的采样机制依赖运行时主动上报，不是全量记录。很多问题看起来“没数据”，其实是采样条件没满足或 profile 类型选错了。
立即学习“go语言免费学习笔记（深入）”；
-
goroutineprofile 只抓当前存活的 goroutine 栈，不区分阻塞/空闲；想查阻塞，要用blockprofile（需开启runtime.SetBlockProfileRate(1)） -
heap默认只显示 live objects（分配后未被 GC 回收的），若想看历史分配总量，访问/debug/pprof/heap?debug=1并确认runtime.ReadMemStats中的Alloc和TotalAlloc差值 - CPU profile 默认采样间隔是 10ms，短于这个时间的函数调用可能被忽略；高精度分析可用
runtime.SetCPUProfileRate(1e6)（单位纳秒），但会显著影响性能 - 容器环境要注意：cgroup 限制可能导致
runtime.ReadMemStats报告的内存与宿主机不一致，pprof heap 数据也可能被截断
pprof 可视化真正的门槛不在命令怎么敲，而在理解每种 profile 的采集时机、作用范围和数据边界。同一个 /debug/pprof/heap URL，GET 两次可能拿到完全不同的结果——取决于那一刻 GC 是否刚跑完、对象是否还活着、甚至 runtime 是否启用了 malloc tracing。
