Golang优雅关闭Web应用技巧

优雅关闭Golang Web应用需完成四步：1.监听系统信号触发关闭流程，使用signal.Notify捕获SIGINT/SIGTERM并阻塞等待；2.调用http.Server的Shutdown()方法停止接收新请求并等待活跃请求完成，配合context控制超时；3.与负载均衡器协作实现连接排空，如Kubernetes中配置preStop钩子延缓退出时间；4.注意避免死锁、设置合理超时、记录清晰日志并测试验证。以上步骤确保服务重启或更新时不中断用户请求且维持数据一致性。

在 Golang 编写的 Web 应用中，优雅关闭（Graceful Shutdown）是一个常被忽视但非常关键的功能。尤其是在部署更新或重启服务时，如果直接杀掉进程，可能会导致正在处理的请求失败，影响用户体验甚至造成数据不一致。

要实现真正的优雅关闭，不仅需要处理系统信号，还要确保已建立的连接能够完成处理，同时拒绝新的请求。下面我们就从几个关键点来说明如何实现这一点。

1. 监听系统信号：捕获中断指令

Golang 程序默认不会对 SIGINT 或 SIGTERM 做特殊处理。为了实现优雅关闭，我们需要手动监听这些信号，并触发关闭流程。

quit := make(chan os.Signal, 1)
signal.Notify(quit, syscall.SIGINT, syscall.SIGTERM)
<-quit

上面这段代码会阻塞直到收到中断信号。一旦收到，就可以开始执行清理逻辑。

建议：

• 使用 signal.Notify 捕获多个常见终止信号。
• 不要在主 goroutine 中直接处理关闭逻辑，而是通过 channel 控制流程。

2. 使用 http.Server 的 Graceful Shutdown 方法

标准库中的 http.Server 提供了 Shutdown() 方法，它会在接收到关闭信号后：

• 停止接收新请求；
• 等待当前活跃的请求完成；
• 关闭底层监听器。

使用方式如下：

srv := &http.Server{Addr: ":8080"}

// 启动服务器
go func() {
    if err := srv.ListenAndServe(); err != nil && err != http.ErrServerClosed {
        log.Fatalf("listen: %s\n", err)
    }
}()

// 等待中断信号
<-quit
log.Println("Shutting down server...")

// 创建一个 context 用于控制超时
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()

if err := srv.Shutdown(ctx); err != nil {
    log.Fatal("Server forced to shutdown:", err)
}

log.Println("Server exiting")

关键点：

• Shutdown() 是非阻塞的，所以要用 context 控制最长等待时间；
• 如果有自定义中间件或 handler，要确保它们能正确响应 context 的取消信号。

3. 配合负载均衡器做连接排空（Drain）

如果你的应用部署在 Kubernetes、Nginx、ELB 等反向代理或负载均衡后面，还需要配合做“连接排空”（Connection Draining），即通知上游不再将新请求打过来。

常见做法包括：

• 在健康检查接口中加入“是否正在关闭”的状态判断；
• 在收到关闭信号后，主动上报服务下线或停止健康检查；
• 给负载均衡器留出足够的时间将现有连接处理完毕。

举个例子： Kubernetes 的 preStop 生命周期钩子可以用来延缓 Pod 被杀掉的时间，让应用有机会完成当前任务：

lifecycle:
  preStop:
    exec:
      command: ["sh", "-c", "sleep 10"]

这个配置会让容器在收到终止信号后等待 10 秒再真正退出，为 Shutdown() 留出更多时间。

4. 注意事项与细节优化

• 避免死锁：确保所有异步操作都支持 context 取消，否则 Shutdown() 可能永远无法完成；
• 设置合理的超时时间：太短可能导致未完成的请求被强制终止；太长又会影响部署效率；
• 日志清晰：记录服务启动和关闭的日志，便于排查问题；
• 测试验证：可以在本地模拟发送 SIGTERM，观察行为是否符合预期。

基本上就这些。只要把信号处理、HTTP Server 的优雅关闭、以及与负载均衡的协作机制做好，你的 Golang Web 应用就能做到“体面地退休”，不影响用户使用体验。