Go 程序如何优雅退出？信号处理要点清楚吗？

在微服务架构中，每秒处理上千请求的服务突然终止如同正在行驶的卡车急刹车——未完成的数据库事务会丢失，进行中的HTTP请求将返回502错误，长耗时的大模型推理任务直接中断。这种粗暴的退出方式会导致：

用户侧感知明显的服务抖动（错误率飙升50%+）
关键业务数据丢失风险（如支付订单未落盘）
资源泄漏导致系统不稳定（数据库连接池未关闭）

某电商平台曾因未实现优雅退出，在服务更新时导致12%的未完成订单丢失，直接经济损失超百万。这验证了实现优雅停机机制的必要性。

信号	触发场景	处理优先级
SIGINT	Ctrl+C终止进程	高
SIGTERM	kill默认信号	高
SIGQUIT	Ctrl+\ 退出	中

// 创建带缓冲的通道
sigChan := make(chan os.Signal, 1)
// 注册需要监听的信号
signal.Notify(sigChan, syscall.SIGINT, syscall.SIGTERM)

缓冲通道设计能避免信号丢失，特别是在高并发场景下。当信号到达时，操作系统会将信号值写入通道。

使用signal.Notify订阅目标信号，建议至少包含SIGINT和SIGTERM两种常见终止信号。

go func() {
    sig := <-sigChan
    log.Printf("收到终止信号: %v", sig)
    close(shutdownChan) // 触发全局关闭事件
}()

HTTP服务器：调用server.Shutdown()等待请求完成
数据库连接：关闭连接池并等待事务提交
消息队列：提交未完成的offset

ctx, cancel := context.WithTimeout(context.Background(), 30time.Second)
defer cancel()
if err := server.Shutdown(ctx); err != nil {
    log.Fatal("强制关闭服务:", err)
}

超时时间设置：根据业务场景设置30到300秒不等，API服务建议120秒
资源释放顺序：先关闭接入层（如HTTP），再处理业务层，最后释放基础设施
双缓冲日志：确保停机期间的日志完整落盘
健康检查联动：在优雅退出期间返回503状态码，通知负载均衡摘除节点

问题现象	根本原因	解决方案
服务无法正常终止	存在未退出的goroutine	使用sync.WaitGroup跟踪协程
数据库连接泄漏	连接池未正确关闭	在shutdown阶段执行db.Close()
优雅退出耗时过长	未设置超时控制	context.WithTimeout必须配置

func main() {
    server := &http.Server{Addr: ":8080"}
    
    // 信号监听通道
    sigChan := make(chan os.Signal, 1)
    signal.Notify(sigChan, syscall.SIGINT, syscall.SIGTERM)
    
    // 优雅退出控制器
    shutdownChan := make(chan struct{})
    
    go func() {
        <-sigChan
        log.Println("开始优雅退出流程")
        
        // 第一步：关闭HTTP服务
        ctx, cancel := context.WithTimeout(context.Background(), 120time.Second)
        defer cancel()
        if err := server.Shutdown(ctx); err != nil {
            log.Fatal("HTTP服务关闭失败:", err)
        }
        
        // 第二步：关闭数据库连接
        if err := db.Close(); err != nil {
            log.Printf("数据库关闭异常:%v", err)
        }
        
        close(shutdownChan)
    }()
    
    // 启动服务
    if err := server.ListenAndServe(); err != http.ErrServerClosed {
        log.Fatal("服务异常终止:", err)
    }
    
    <-shutdownChan
    log.Println("服务安全退出")
}

通过合理运用Go的并发特性和信号处理机制，开发者可以构建出平均停机时间小于2秒的高可靠服务。建议在Kubernetes等容器平台中配合preStop钩子使用，实现真正的零停机更新。