Golang优雅停机：信号处理与资源释放详解

优雅停机的关键在于及时响应退出信号并有序释放资源。1.通过os/signal包监听SIGINT/SIGTERM信号触发关闭流程；2.使用http.Server.Shutdown方法平滑关闭HTTP服务，允许正在进行的请求完成；3.通过defer和sync.WaitGroup确保数据库连接、消息队列、文件句柄等资源被正确释放；4.避免使用log.Fatal或os.Exit强制退出，保证清理逻辑完整执行。整个过程需用带超时的上下文控制关闭时限，最终实现应用"干净"退出。

在云原生环境中，优雅停机（Graceful Shutdown）是确保服务在重启、升级或缩容时不影响用户体验的关键环节。Golang 本身对信号处理和并发控制支持良好，非常适合用来实现优雅停机逻辑。关键在于正确监听系统信号，并在收到终止信号后，合理地释放资源并拒绝新请求。

监听系统信号，捕捉退出时机

Go 程序默认不会主动响应 SIGTERM 或 SIGINT 这类中断信号，除非你显式地注册了监听器。我们需要通过 os/signal 包来捕获这些信号：

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

一旦程序接收到这类信号，就可以开始执行清理逻辑。通常的做法是启动一个后台 goroutine 来等待信号触发：

• 使用 signal.Notify 注册感兴趣的信号
• 在主函数中阻塞等待信号到来
• 收到信号后，关闭 HTTP Server、断开数据库连接等操作

注意：不要使用 log.Fatal 或 os.Exit() 强制退出，这样会跳过 defer 的清理逻辑。

实现 HTTP 服务的优雅关闭

如果你的应用是一个 HTTP 服务，可以通过 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)
    }
}()

<-sigChan // 等待信号

ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()

if err := srv.Shutdown(ctx); err != nil {
    log.Println("Server Shutdown:", err)
}

这段代码做了几件事：

• 启动 HTTP 服务并在单独的 goroutine 中运行
• 等待系统信号
• 创建带超时的上下文，防止关机卡住
• 调用 Shutdown 方法停止服务，同时允许已有的请求完成

这种方式能保证正在处理的请求有机会完成，而不是被强制中断。

处理其他资源的释放与清理

除了 HTTP 服务，你的应用可能还持有数据库连接、消息队列消费者、临时文件、锁等资源。优雅停机的一个重要部分就是确保这些资源被正确释放。

可以借助 defer 和 sync.WaitGroup 来管理多个清理任务：

• 数据库连接池关闭：db.Close()
• 消息队列消费者取消订阅：调用 consumer.Cancel()
• 文件句柄、锁的释放：使用 defer file.Close() 或类似方式
• 清理中间状态或缓存数据：比如写入日志、清除 session

举个例子，如果使用 Redis 客户端：

client := redis.NewClient(&redis.Options{...})
defer client.Close()

或者使用 WaitGroup 控制异步清理任务的顺序：

var wg sync.WaitGroup
wg.Add(1)
go func() {
    defer wg.Done()
    // 执行某个资源的清理工作
}()
wg.Wait()

只要在收到信号后，把所有清理任务有序执行完毕，就能保证应用“干净”地退出。

基本上就这些。优雅停机的核心在于及时响应退出信号，并给各个组件足够的时间完成收尾工作。虽然每个步骤都不复杂，但很容易因为漏掉某些资源释放而引发问题。