Go语言优雅退出实现方法

Go服务的优雅退出并非默认行为，必须手动监听SIGINT/SIGTERM信号，调用http.Server.Shutdown()并传入带超时的context（如15秒，需略长于最长请求耗时），才能避免进程“猝死”导致请求中断、日志截断、事务回滚失败等严重问题；同时所有后台goroutine必须统一响应同一ctx.Done()通道退出，而非依赖硬等待或忽略上下文——掌握这套机制，你的Go服务才能真正实现平滑下线、高可用与生产级健壮性。

Go 服务必须手动监听 SIGINT/SIGTERM，调用 http.Server.Shutdown() 并传入带超时的 context.Context，否则所有正在处理的请求都会被强制中断。

为什么 http.ListenAndServe() 不能直接退出

它本身是阻塞调用，但不响应任何系统信号；一旦收到 Ctlr+C 或容器发来的 SIGTERM，进程立即终止，defer 不执行、连接重置、日志截断、数据库事务回滚不完整。这不是“退出”，是“猝死”。

常见错误现象：

• 压测中发 kill -15 后，curl 突然报 Connection reset by peer
• 日志最后一行停在中间，比如 processing req id=abc... 就没了
• netstat -an | grep :8080 显示大量 TIME_WAIT 或残留 ESTABLISHED

http.Server.Shutdown() 怎么用才不卡住

它只是发起关闭通知，不等待完成——必须配超时 context.WithTimeout()，且超时时间得略大于你最长请求预期耗时（比如 15 秒，不是 5 秒）。

关键参数和顺序：

• 调用 srv.Shutdown() 前，srv.Listener 已自动关闭，新连接进不来
• ctx 必须是带超时的，不能用 context.Background() 或 context.TODO()
• 错误要忽略 http.ErrServerClosed，其他错误该 log.Fatal() 就 log.Fatal()
• 不要在 Shutdown() 调用后立刻 os.Exit(0)，得等它返回（它返回 ≠ 所有连接结束，但已进入清理阶段）

示例片段：

ctx, cancel := context.WithTimeout(context.Background(), 15*time.Second)
defer cancel()
if err := srv.Shutdown(ctx); err != nil && err != http.ErrServerClosed {
    log.Printf("server shutdown error: %v", err)
}

后台 goroutine 怎么同步退出

所有长期运行的 goroutine（比如消息消费者、定时任务、健康检查）都必须监听同一个 ctx.Done()，不能靠 time.Sleep() 或无条件 for {} 硬等。

容易踩的坑：

• 用 select { case ，而不是 if ctx.Err() != nil { return } —— 后者只查一次，错过信号
• 清理逻辑（如 db.Close()、redisPool.Close()）必须写在 case 分支里，不能丢进 defer —— defer 在函数返回时才触发，而你得确保它在收到信号后立刻执行
• 多个服务共用一个 ctx，用 sync.WaitGroup 等待全部 goroutine 退出，wg.Wait() 放在 main() 最后，别放 defer

信号监听为什么收不到 SIGTERM

signal.Notify() 只注册监听，不阻塞；如果注册完没接信号，主 goroutine 直接退出，整个进程就结束了，根本来不及响应。

必须保证主 goroutine 持续存活直到 Shutdown 完成：

• channel 必须带缓冲：sigChan := make(chan os.Signal, 1)，否则可能漏第一个信号
• 要用 <-sigChan 阻塞等待，或 for range sigChan 循环接收（但一般只收一次）
• 收到信号后，启动 Shutdown 流程，然后 return 或 os.Exit(0) —— 别在 signal handler 里做耗时操作

最简可靠结构：

sigChan := make(chan os.Signal, 1)
signal.Notify(sigChan, syscall.SIGINT, syscall.SIGTERM)
<-sigChan // 阻塞等待
// 启动 Shutdown...

真正难的不是写几行 Shutdown()，而是所有 handler、所有 goroutine、所有第三方库（比如日志、DB 驱动、TLS 配置）都得支持 ctx 取消——漏一个，就可能卡住整个退出流程。

今天关于《Go语言优雅退出实现方法》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！