Echo框架中需用middleware.TimeoutWithConfig()注册Timeout中间件,显式配置Timeout字段(如10秒),可自定义响应体与状态码(如408或504),支持按路由组设置差异化超时(如/api设5秒、/upload设10分钟)。

在Echo框架中为HTTP请求设置超时时间,防止长时间阻塞导致服务不可用,需通过Timeout中间件控制处理耗时。该中间件会自动中断超过指定时间的请求,并返回503状态码,避免goroutine泄漏。
启用Timeout中间件
在Echo实例上使用e.Use(middleware.TimeoutWithConfig())注册中间件,配置项必须显式传入,不能省略空结构体。
调用middleware.TimeoutWithConfig()时传入middleware.TimeoutConfig结构体,其中Timeout字段设为time.Second * 10表示10秒超时阈值。
配置超时响应内容
方法一:自定义超时响应体和状态码
在TimeoutConfig中设置ErrorMessage为"Request timeout",StatusCode为http.StatusRequestTimeout(408)。
Echo框架 5.1.0 版本源码包下载,适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
方法二:复用默认响应但修改状态码
不设置ErrorMessage,仅将StatusCode改为http.StatusGatewayTimeout(504),此时响应体仍为默认的"Timeout"字符串。
【Timeout中间件一旦触发,原Handler中的后续逻辑将被强制终止,已执行的数据库查询或文件写入不会自动回滚】
按路由分组设置不同超时时间
第一步:创建主Echo实例e := echo.New();
第二步:对普通API路由组api := e.Group("/api")调用api.Use(middleware.TimeoutWithConfig(...)),配置Timeout: time.Second * 5;
第三步:对上传接口路由组upload := e.Group("/upload")单独配置Timeout: time.Minute * 10,避免大文件上传被误杀。
注意:中间件作用范围以注册位置为准,子路由组继承父组中间件,但可覆盖重置。

















