Fiber 无真正路由级超时,必须在 handler 开头用 c.Context().SetDeadline() 显式设限;fiber.Timeout 中间件已弃用且无效;Read/WriteTimeout 仅作用于 TCP 层,不控制 handler 执行。

Fiber 没有真正的路由级超时配置能力,所谓“给某个 GET 路由设 3 秒超时”在底层不可行;必须用 context.WithTimeout 手动注入、显式检查、分层设限,否则全是假超时。
fiber.Timeout 中间件是空壳,别用
Fiber 的 fiber.Timeout 中间件早在 v2.5+ 就被标记为 deprecated,源码里是空实现:不设 deadline,不 cancel ctx,压测时完全不生效。官方文档还没删,但你调 app.Use(fiber.Timeout()) 就等于没写。它不会触发 c.Context().Done(),也不会让 c.Context().DeadlineExceeded() 返回 true —— 这个中间件只是个占位符。
真正生效的超时只能在 handler 开头手动设
唯一可靠方式是在每个 handler 函数第一行调用 c.Context().SetDeadline(),且必须用 fasthttp 原生 context(不是标准 context.Context):
-
c.Context().SetDeadline(time.Now().Add(2 * time.Second))是唯一能影响 fasthttp 底层读写行为的调用 - 必须放在 handler 最开头,中间件里设无效 —— 因为每个
c.Context()是独立实例,中间件改的是自己的副本 - 下游调用(DB、HTTP client、Redis)前建议再设一次 deadline,避免 handler 内部耗时掩盖真实阻塞点
- 超时后
c.Context().DeadlineExceeded()立即返回 true,此时必须return,不能继续调c.SendString()或写 body
按下游服务隔离设 timeout,别统一配
不同接口依赖的服务响应能力差异极大,/api/users(PostgreSQL)和 /api/search(Elasticsearch)不可能共用一个 timeout:
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
- 用
app.Group("/api/users")+ 独立 handler 是最清晰的组织方式,每个 handler 自己控制 deadline - 不要试图用闭包封装成 “通用 timeout 中间件”,因为 fasthttp 的 context 不传播 cancel 信号,中间件设的 deadline 对 handler 里的
c.Context()无影响 - 若真要复用逻辑,用函数工厂:
func makeUserHandler(timeout time.Duration) fiber.Handler { return func(c *fiber.Ctx) error { c.Context().SetDeadline(time.Now().Add(timeout)); ... } } -
fiber.Config{ReadTimeout}和WriteTimeout是 TCP 连接层超时,只管 read header/write response 耗时,不约束 handler 执行 —— 设了 5 秒,handler 跑 10 秒照样不中断
超时后连接不自动断,得手动止损
fasthttp 在 SetDeadline 触发后,如果 handler 已调 c.Status(200) 并开始写 body,它不会强行关闭 TCP 连接。后果很实际:
- 客户端卡在等待 body 流完,P99 延迟虚高
- 连接池堆积,fd 耗尽
- 日志里看不到 “timeout”,只有模糊的 “client disconnected”
- 补救只有两条:
if c.Context().DeadlineExceeded() { return }+ 所有下游 client(如http.Client)必须传自己带 timeout 的context.Context,例如req.WithContext(ctx)
最容易被忽略的是:超时不是开关,而是协作契约。你设了 deadline,DB 驱动、HTTP client、甚至你自己的 for 循环,都得主动检查 ctx.Done() 或 ctx.Err() —— 缺一环,整个超时就失效。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










