因为Iris的HTTP handler是同步执行的，耗时操作会阻塞goroutine并占用P，导致并发性能下降；应将耗时逻辑移入新goroutine，主handler立即返回202，并用ctx.Done()监听客户端断开。
为什么直接在 Iris 路由 handler 里跑耗时操作会卡住整个服务？
Iris 默认使用 Go 的 net/http 底层，每个请求由一个 goroutine 处理，但它的路由匹配和中间件执行是同步的。如果你在 ctx.Handler 里写个 time.Sleep(10 * time.Second) 或调用阻塞式数据库查询、外部 HTTP 请求、大文件处理，这个 goroutine 就会挂起 —— 不仅当前请求没响应，还会占用 runtime 的 P（Processor），影响其他并发请求的调度效率。尤其在高并发下，连接池耗尽、超时堆积、CPU 看似空闲但 QPS 暴跌，都是典型症状。
用 goroutine + channel 配合 ctx.Done() 主动退出
最轻量、最可控的方式：把阻塞逻辑扔进新 goroutine，主 handler 立即返回 202 Accepted，并通过 ctx.Done() 监听客户端断开，及时清理资源。
- 永远不要在 goroutine 里直接调用
ctx.JSON()或任何写响应的操作 —— 响应头已发，再写会 panic - 用
ctx.Values().Set("task_id", id)存临时标识，方便后续轮询或 WebSocket 推送状态 - 务必 select +
ctx.Done()判断是否该中止任务，避免“幽灵 goroutine”泄露 - 示例片段：
app.Post("/process", func(ctx iris.Context) { taskID := uuid.NewString() ctx.Values().Set("task_id", taskID) ctx.StatusCode(iris.StatusAccepted) ctx.JSON(iris.Map{"task_id": taskID, "status": "accepted"}) <pre class="brush:php;toolbar:false;">go func() { select { case <-time.After(8 * time.Second): // 模拟耗时操作 // 更新 DB / 写入结果等 case <-ctx.Done(): // 客户端已断开 return } }()})
Skill Weave Chains — 技能链路由引擎下载开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
需要实时进度反馈？别用轮询，改用 WebSocket + Iris 事件广播
轮询（如每秒 GET /task/{id}/status）在大量任务时会造成指数级请求压力。Iris 原生支持 WebSocket，配合 socketio 或内置的 websocket 包更合适。
- 启动时注册 WebSocket 路由：
app.Get("/ws", websocket.Handler(server)) - 任务 goroutine 中，用
server.BroadcastToRoom("task:"+taskID, message)推送进度，前端监听对应 room - 注意：WebSocket 连接生命周期独立于 HTTP 请求，
ctx.Done()对它无效，需单独管理连接状态 - 若坚持用轮询，至少加缓存：用
sync.Map存 task ID → status，GET 接口只读 map，不查 DB
真正的大任务（如视频转码、批量导出）必须剥离到独立服务
哪怕用了 goroutine，长时间运行仍会拖慢 Iris 实例的 GC 周期、内存分配器响应，甚至触发 runtime 的抢占延迟。生产环境该切就切。
- 用消息队列（RabbitMQ/Kafka）解耦：HTTP 接口只发任务消息，Worker 服务消费并执行
- Iris 只保留轻量接口：提交任务（POST）、查状态（GET）、取消任务（DELETE）
- 状态存储建议用 Redis：key 为
task:{id}，value 是 JSON 结构，天然支持过期（EXPIRE）和原子更新 - 别在 Iris 里启 Worker：它不是任务调度器，硬塞进去只会让部署、扩缩容、监控全部变复杂
真正容易被忽略的是上下文生命周期错配 —— ctx 只活到 handler 返回，但 goroutine 里的日志、DB 连接、HTTP client 往往还拿着它。所有跨协程使用的资源，必须显式传参或用独立 context（如 context.WithTimeout(context.Background(), ...)），而不是复用 ctx。
