Iris中集成pprof必须显式注册通配路由：app.Any("/debug/pprof/{p:path}", iris.FromStd(http.HandlerFunc(pprof.Index)))，否则因不兼容DefaultServeMux而404；注册须在app.Listen前，且生产环境必须加鉴权或内网限制。
GoLand 本身没有专为 Iris 框架设计的 “pprof 插件”，也不存在官方或社区维护的「Iris + pprof 集成插件」。你真正需要做的，是手动把 net/http/pprof 挂载到 Iris 的路由系统里——否则访问 /debug/pprof/ 会直接 404。
Iris 中 /debug/pprof 返回 404 怎么办
Iris 不使用 http.DefaultServeMux，只导入 _ "net/http/pprof" 完全无效。必须显式注册 handler，并注意路径前缀处理。
-
net/http/pprof的所有子路径（如/debug/pprof/heap、/debug/pprof/goroutine）都依赖http.HandlerFunc(pprof.Index)做路由分发 - Iris 的
app.Handle或app.Get无法直接代理整个子树；要用app.Any+iris.FromStd包装
正确做法：
- 在启动服务前，确保已导入
_ "net/http/pprof" - 用
app.Any("/debug/pprof/{p:path}", iris.FromStd(http.HandlerFunc(pprof.Index))) - 注意
{p:path}是 Iris 的通配符语法，等价于其他框架的*pprof或**
别漏掉这三件事：
- 路由注册必须在
app.Listen之前 -
http.HandlerFunc(pprof.Index)不能换成pprof.Handler("heap")等具体 handler，否则子路径跳转和 UI 路由会断 - 如果用了
app.UseGlobal中间件（比如日志、CORS），它们可能拦截/debug/pprof/请求，建议加白名单逻辑或临时禁用
如何验证 pprof 在 Iris 中生效了
启动后执行：
-
curl <a href="https://www.php.cn/link/1f63336dce12faa21ce6360b9a424374">https://www.php.cn/link/1f63336dce12faa21ce6360b9a424374</a>→ 应返回 HTML 列表（含 heap、goroutine、profile 等链接） -
curl <a href="https://www.php.cn/link/1f63336dce12faa21ce6360b9a424374heap?gc=1">https://www.php.cn/link/1f63336dce12faa21ce6360b9a424374heap?gc=1</a>→ 应返回二进制 profile 数据（非 404 或空响应） -
go tool pprof -http=:8081 <a href="https://www.php.cn/link/1f63336dce12faa21ce6360b9a424374heap?gc=1">https://www.php.cn/link/1f63336dce12faa21ce6360b9a424374heap?gc=1</a>→ 能打开火焰图界面
如果返回 404，99% 是因为没注册通配路由，或注册顺序错了（比如写在 app.Listen 后面）。
生产环境 Iris 开启 pprof 的安全红线
Iris 默认不带鉴权中间件，/debug/pprof/ 暴露后等于把内存快照、调用栈、命令行参数全交出去。
必须加防护：
- 只监听内网地址：用
app.Listen("127.0.0.1:6060")，别用0.0.0.0:6060 - 加 Basic Auth：在挂载前套一层中间件，例如：
auth := func(ctx iris.Context) { user, pass, _ := ctx.Request().BasicAuth() if user != "admin" || pass != os.Getenv("PPROF_PASS") { ctx.StatusCode(iris.StatusUnauthorized) return } ctx.Next() } app.Any("/debug/pprof/{p:path}", auth, iris.FromStd(http.HandlerFunc(pprof.Index))) - 或更简单：用反向代理（Nginx）做 IP 白名单 + Auth，Iris 层不碰鉴权逻辑
最常被忽略的一点：pprof 的 /debug/pprof/trace 和 /debug/pprof/profile 是阻塞式采样，一次 CPU profile 会停应用 30 秒。压测中误点就等于主动拒绝服务。
