Fiber默认启动不优雅,因app.Listen()直接阻塞主线程且未封装http.Server.Shutdown()逻辑,导致收到SIGINT/SIGTERM时无法等待请求完成即退出,易引发连接重置、日志截断等问题。

为什么 Fiber 的默认启动不“优雅”?
直接调用 app.Listen() 会阻塞主线程,且进程收到 SIGINT 或 SIGTERM 时,Fiber 不会等待正在处理的 HTTP 请求完成就退出,容易导致连接重置、响应丢失或中间件(如日志、事务)未清理。
根本原因:底层用的是 net/http.Server,而 Fiber 默认没封装它的 Shutdown() 调用逻辑。
如何用 http.Server 手动接管启动与关闭?
必须绕过 app.Listen(),改用标准库的 http.Server 实例启动,并自行监听信号、触发 Shutdown()。这是目前最可靠的方式。
- 创建
http.Server时,把app.Handler()作为Handler字段传入 - 启动前启动一个 goroutine 监听
os.Interrupt和syscall.SIGTERM - 收到信号后,调用
server.Shutdown(),并传入带超时的context -
Shutdown()会等待活跃连接完成或超时,但不会接受新请求
srv := &http.Server{
Addr: ":3000",
Handler: app.Handler(),
}
go func() {
if err := srv.ListenAndServe(); err != nil && err != http.ErrServerClosed {
log.Fatal(err)
}
}()
sig := make(chan os.Signal, 1)
signal.Notify(sig, os.Interrupt, syscall.SIGTERM)
<-sig
log.Println("shutting down server...")
ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
defer cancel()
if err := srv.Shutdown(ctx); err != nil {
log.Fatal("server shutdown failed:", err)
}
fiber.New() 配置里哪些字段影响优雅关闭?
没有直接控制优雅关闭的选项 —— Fiber 的配置如 DisableStartupMessage、ServerHeader 等都不干预生命周期管理。唯一相关的是 DisableKeepAlive,但它只影响连接复用,关掉它反而可能让 Shutdown() 等待更久(因更多长连接未及时断开)。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
立即学习“go语言免费学习笔记(深入)”;
- 别指望靠
fiber.Config实现优雅关机,必须手动接管http.Server - 若用了
app.Use(logger.New()),确保日志中间件本身不阻塞(比如异步写日志),否则Shutdown()可能卡在日志 flush 上 - 自定义中间件中若有长耗时操作(如同步 DB commit),需配合上下文超时判断,避免拖垮整个关机流程
常见错误:用 app.Listen() + signal.Notify 组合?
这种写法看似合理,实则无效:app.Listen() 内部调用 http.Server.ListenAndServe() 后会永久阻塞,signal.Notify 的接收逻辑根本没机会执行。
- 错误示例:
app.Listen(":3000")放在signal.Notify后面 → 永远执行不到 - 错误示例:
go app.Listen(":3000")后监听信号 → 虽能收到信号,但无法触发Shutdown(),因为没持有http.Server实例 - 更隐蔽的坑:用第三方封装库(如
fiber/v2/middleware/helmet)不会自动帮你做关机,该自己管还得自己管
真正要记住的只有一条:只要没拿到 *http.Server,就谈不上优雅关闭 —— 这是 Go HTTP 生态的通用契约,Fiber 并未破例。

















