Iris不支持单路由超时配置，只能通过ctx.Timeout()结合全局WriteTimeout实现：在handler中调用ctx.Timeout()设置请求级deadline，并确保所有外部调用传入该context，同时全局WriteTimeout需大于等于最长单路由超时值，否则响应可能被强制中断。
单路由不能直接设超时，Iris 没有 per-route timeout 配置项
Iris 的 iris.ReadTimeout、iris.WriteTimeout 等都是全局 Server 级配置，作用于整个 app.Run() 启动的 HTTP 服务。你没法在 app.Get("/slow", handler) 里传一个超时参数，也没有类似 app.Get("/slow", handler).WithTimeout(120*time.Second) 的链式调用。
想让某条路由更“耐等”，得靠中间件 + ctx.Request().Context()
核心思路是：不改 Server 超时，而在 handler 内部用 ctx.Request().Context() 控制该请求自身的执行生命周期。Iris 的 Context 是标准 http.Request.Context() 的封装，天然支持 cancel 和 deadline。
- 在 handler 开头调用
ctx.Timeout(120 * time.Second)（Iris 内置方法），它会基于当前 request context 创建带 deadline 的子 context，并挂载到ctx上 - 后续所有依赖
ctx的操作（如数据库查询、HTTP 调用、文件读写）都应传入该 context，否则超时无效 - 若 handler 执行超时，
ctx.IsStopped()会返回 true，此时应立即返回，避免继续执行 - 注意：这个 timeout 不影响 HTTP 响应头或连接层行为，只控制 handler 内部逻辑；客户端仍可能因 Server 全局
WriteTimeout被断连
示例：
app.Get("/report", func(ctx iris.Context) {
// 给这条路由单独加 5 分钟执行上限
if !ctx.Timeout(5 * time.Minute) {
ctx.StatusCode(408)
ctx.WriteString("Request timeout")
return
}
<pre class="brush:php;toolbar:false;">// 所有外部调用必须传 ctx.Request().Context()
data, err := heavyDBQuery(ctx.Request().Context())
if err != nil {
ctx.StatusCode(500)
return
}
ctx.JSON(data)})
真正影响响应中断的还是全局 WriteTimeout
即使你在 handler 里用了 ctx.Timeout()，如果 Server 的 iris.WriteTimeout 设得太短（比如默认 30 秒），HTTP 连接会在写入响应体前被底层 http.Server 强制关闭，导致客户端收到不完整响应或 connection reset。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 若某类路由普遍耗时长（如导出、大文件生成），应在
app.Run()时统一调大iris.WriteTimeout，而不是逐个加中间件 - 若只有极个别路由需要长超时，又不想拉高全局值，可考虑拆成独立子服务（如另起一个
iris.Application绑定不同端口/域名），但需权衡运维复杂度 - 别忽略 pprof 场景：访问
/debug/pprof/profile?seconds=60时，若WriteTimeout ，profile 文件大概率损坏——这是最常被踩的坑
不要用 http.TimeoutHandler 包裹 Iris handler
有人试图用标准库的 http.TimeoutHandler 套一层再注册进 Iris，例如：app.Get("/slow", iris.FromStd(http.TimeoutHandler(...)))。这会导致：
-
ctx对象失效：Iris 的Context无法从http.TimeoutHandler透传进来，ctx.Params()、ctx.JSON()全部不可用 - 中间件链断裂：Iris 的
Use、UseGlobal注册的中间件不会执行 - 状态码错误：超时后返回的是 503，且无法自定义响应体
这条路走不通，硬套只会让问题更隐蔽。
真正要实现“单路由可控超时”，只能靠 ctx.Timeout() + 显式 context 传递 + 全局 WriteTimeout 协同。最容易被忽略的是：handler 里调用的第三方函数是否接收并使用了 context —— 如果没传，timeout 就只是摆设。
