如何在Echo框架中配置请求超时中间件-Golang-PHP中文网

echo 的 httperrorhandler 捕获不到超时错误，因 net/http 底层超时（如 readheadertimeout）直接关闭连接，请求未进入 echo 中间件链；真正生效的超时必须配置在 http.server 实例上，而非 echo 实例；单 handler 业务超时需用 context.withtimeout(c.request().context(), ...) 并返回 echo.newhttperror() 才能触发自定义错误处理器。

如何在echo框架中配置请求超时中间件

echo.HTTPErrorHandler 捕获不到超时错误？

不是中间件写得不对，而是根本走不到它——net/http 底层的超时（如 ReadHeaderTimeout、IdleTimeout）会直接关闭连接，请求压根没进入 Echo 的中间件链。你看到的 context deadline exceeded 是 http.Server 自己抛的，和 c.SetTimeout() 无关。

全局超时必须配在 http.Server，不是 Echo 实例上

所有真正生效的超时控制都来自 http.Server 字段，Echo 只是封装。常见配置项及用途：

ReadHeaderTimeout：连接建立后，读完请求头的最大时间（防慢速攻击）
IdleTimeout：HTTP/1.1 keep-alive 场景下，两次请求间的最大空闲时间
WriteTimeout：从开始写响应到写完的总时间（含 Flush），不包含读请求头或 body 的时间

示例写法：

e := echo.New()
server := &http.Server{
    Addr: ":8080",
    Handler: e,
    ReadHeaderTimeout: 5 * time.Second,
    IdleTimeout:       60 * time.Second,
    WriteTimeout:      30 * time.Second,
}
server.ListenAndServe()

单个 handler 要业务超时，用 context.WithTimeout() 派生子 context

这是唯一可控、可触发 echo.HTTPErrorHandler 的方式。注意三点：

Echo框架 5.1.0

Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。

下载

必须基于 c.Request().Context() 派生，别用 c.Context()（已被 Echo 包装，取消它可能干扰内部逻辑）
务必调用 defer cancel()，否则 goroutine 泄漏
超时后要返回 echo.NewHTTPError()，才能进自定义错误处理器；直接返回原始 error 或 panic 不会触发

典型用法：

func timeoutHandler(c echo.Context) error {
    ctx, cancel := context.WithTimeout(c.Request().Context(), 3*time.Second)
    defer cancel()
    result, err := db.QueryContext(ctx, "SELECT ...")
    if err != nil {
        if errors.Is(err, context.DeadlineExceeded) {
            return echo.NewHTTPError(http.StatusRequestTimeout, "DB query timeout")
        }
        return err
    }
    return c.JSON(http.StatusOK, result)
}