因为net/http/pprof的init()函数仅向http.DefaultServeMux注册路由，而Iris使用独立路由树，不读取DefaultServeMux，故import _ "net/http/pprof"无效；需手动用iris.FromStd()封装各pprof handler并注册到Iris路由，同时注意路径后缀、超时配置及访问控制。
为什么直接 import _ "net/http/pprof" 在 Iris 里不生效
因为 net/http/pprof 的 init() 函数只把 handler 注册到 http.DefaultServeMux，而 Iris 使用的是自己实现的路由树（基于 muxie），完全不读取 DefaultServeMux。所以即使你写了 import _ "net/http/pprof"，访问 /debug/pprof/ 依然 404。
怎么手动把 pprof handler 挂到 Iris 路由上
Iris 没有官方 pprof 封装库（不像 Gin 有 gin-contrib/pprof），必须显式注册每个 endpoint。关键点是：用 app.Get() 或 app.Any() 绑定标准库的 pprof 函数，并注意路径后缀和 handler 类型匹配：
-
app.Get("/debug/pprof/", iris.FromStd(pprof.Index))—— 主页必须带尾部/，且要用iris.FromStd()转换为 Iris handler app.Get("/debug/pprof/cmdline", iris.FromStd(pprof.Cmdline))app.Get("/debug/pprof/profile", iris.FromStd(pprof.Profile))app.Get("/debug/pprof/symbol", iris.FromStd(pprof.Symbol))app.Get("/debug/pprof/trace", iris.FromStd(pprof.Trace))app.Get("/debug/pprof/goroutine", iris.FromStd(pprof.Handler("goroutine")))app.Get("/debug/pprof/heap", iris.FromStd(pprof.Handler("heap")))
漏掉任意一个（尤其是 /debug/pprof/cmdline 或 /debug/pprof/symbol）都可能导致 go tool pprof 解析失败，报 Failed to get the number of symbols。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
CPU profile 采样被截断？检查 Iris 的 WriteTimeout
Iris 默认的 WriteTimeout 是 30 秒，而 pprof.Profile 默认也采样 30 秒。一旦两者相等，HTTP 响应可能在写入完成前被强制关闭，导致 profile 文件损坏、go tool pprof 无法加载。
- 启动 server 前显式调大超时：
app.Run(iris.Addr(":8080"), iris.WriteTimeout(60*time.Second)) - 或者缩短采样时间：
wget "http://localhost:8080/debug/pprof/profile?seconds=10" - 别依赖默认值——Iris 不像 net/http.Server 那样对 pprof 做特殊兼容
生产环境暴露 pprof 必须加访问控制
Iris 没有类似 Gin 的 Group().Use() 语法糖，但可以用中间件 + 路径前缀实现最小侵入保护：
- 定义一个仅允许内网访问的中间件：
func allowLocalOnly(ctx iris.Context) { if !strings.HasPrefix(ctx.Request().RemoteAddr, "127.0.0.1:") && !strings.HasPrefix(ctx.Request().RemoteAddr, "10.") { ctx.StatusCode(403); return } ctx.Next() } - 注册 pprof 路由时加前缀：
debug := app.Party("/admin/debug", allowLocalOnly); debug.Get("/pprof/{action:path}", iris.FromStd(http.HandlerFunc(pprof.Index)))—— 注意这里要处理通配，不能只写死单个路径 - 绝对不要只拦截
/admin/debug/pprof/而放行/admin/debug/pprof/heap，攻击者可直接绕过
最易忽略的一点：Iris 的 Party() 不自动继承父级中间件，必须显式传入；且 {action:path} 这种通配写法必须配合 iris.FromStd() 和正确的 handler 分发逻辑，否则子路径 404。
