Echo框架不自动为echo.Context注入带超时的context.Context,必须通过中间件显式调用context.WithTimeout()创建并存入c.Set(),handler中需类型断言获取后用于DB或外部服务调用,同时配合http.Server级超时防连接堆积。

echo.Context超时必须靠中间件手动注入,框架不自动绑定
Echo 不会在 echo.Context 里自动塞进带超时的 context.Context,c.Request().Context() 默认是 background,不会随 HTTP 连接生命周期终止。如果你在 handler 里直接用它做数据库查询或调外部服务,超时完全无效。
必须显式用中间件把带超时的 context 注入到 c 中,并统一在 handler 开头替换掉原始 context:
- 推荐在
e.Pre()或全局e.Use()阶段注册,确保所有路由都覆盖 - 不要在每个 handler 里重复写
ctx, cancel := context.WithTimeout(...),容易漏、难维护 - 超时值建议分层:HTTP 层(如 30s) > DB 层(如 5s) > 外部 API 层(如 2s),避免上层 timeout 被下层拖死
用 context.WithTimeout + c.Set() 实现请求级超时控制
典型做法是新建一个中间件,在请求进入时创建带超时的子 context,并存入 echo.Context;handler 内通过 c.Get("timeout_ctx") 取用,而不是直接用 c.Request().Context():
func TimeoutMiddleware(timeout time.Duration) echo.MiddlewareFunc {
return func(next echo.HandlerFunc) echo.HandlerFunc {
return func(c echo.Context) error {
ctx, cancel := context.WithTimeout(c.Request().Context(), timeout)
defer cancel()
c.Set("timeout_ctx", ctx)
return next(c)
}
}
}
<p>// handler 中使用
func myHandler(c echo.Context) error {
ctx := c.Get("timeout_ctx").(context.Context)
rows, err := db.QueryContext(ctx, "SELECT * FROM users WHERE id = ?", c.Param("id"))
if err != nil {
if errors.Is(err, context.DeadlineExceeded) {
return echo.NewHTTPError(http.StatusGatewayTimeout, "DB query timed out")
}
return err
}
// ...
}
</p>
注意:c.Set() 存的是 interface{},取用时需类型断言;若担心 panic,可用 if val, ok := c.Get("timeout_ctx").(context.Context); ok { ... } 安全判断。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
别混淆 HTTP Server 级超时和请求级超时
http.Server 的 ReadTimeout、WriteTimeout、IdleTimeout 控制的是连接生命周期,不是单个请求处理逻辑的超时。它们无法中断正在执行的 handler,只影响底层 TCP 连接读写阶段。
-
ReadTimeout:从客户端发请求头开始,到完整读完 body 的最大耗时(不包括 handler 执行) -
WriteTimeout:从 handler 返回开始,到响应完整写出的上限(也不含 handler 执行) - 真正要中断长时间运行的 handler(比如卡在 DB 查询或第三方 API),只能靠注入到
echo.Context的子 context - 两者必须配合:Server 级超时防连接堆积,请求级 context 超时防 goroutine 泄漏
超时后记得主动清理资源,否则会泄漏
一旦 context.DeadlineExceeded 触发,handler 应立即返回,但已启动的异步操作(如 goroutine、长轮询、streaming 响应)不会自动取消——你得手动关。
- 数据库连接池本身支持 context,
QueryContext/ExecContext会自动中断,不用额外处理 - gRPC 客户端调用必须用
ctx,否则超时无效;HTTP 客户端也必须设client.Timeout或用Do(req.WithContext(ctx)) - 如果 handler 启了 goroutine 并传了
c,超时后该 goroutine 仍可能继续执行并调c.JSON()—— 此时c.Response()已关闭,会 panic 或静默失败 - WebSocket 或 SSE 场景更危险:超时后连接还挂着,必须监听
ctx.Done()主动 close conn
最易被忽略的一点:超时中间件里的 defer cancel() 是必须的,漏掉会导致 context 泄漏,尤其在高并发短连接场景下,内存增长会非常隐蔽。










