Golang优雅关闭：信号处理与goroutine协调方法

优雅关闭Go程序需捕获信号、通知goroutine退出、等待清理完成并可选超时保护。首先通过os/signal包监听SIGINT和SIGTERM信号，使用带缓冲的channel接收信号；接着用context或done channel通知所有工作goroutine退出；再通过sync.WaitGroup确保所有goroutine完成清理；最后可结合select和time.After设置退出超时机制，防止长时间阻塞。

在Go程序中，优雅关闭（Graceful Shutdown）是确保程序退出时能处理完当前任务、释放资源、不丢数据的关键步骤。要实现这一点，需要协调信号处理和goroutine的退出机制。

如何捕获系统信号

Go程序可以通过 os/signal 包来监听操作系统发送的信号，最常用的是 SIGINT 和 SIGTERM。这两个信号通常由用户按下 Ctrl+C 或服务管理工具（如 systemd）发出。

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

上面这段代码创建了一个带缓冲的channel，并注册了对两个常见终止信号的关注。一旦收到这些信号，就会向这个channel发送一个值，你可以在这里触发退出逻辑。

注意：不要使用无缓冲的channel，否则可能漏掉信号。

如何通知所有goroutine退出

当主goroutine收到退出信号后，需要通知其他工作goroutine停止执行。常见的做法是使用一个 context.Context 或者一个关闭的channel作为“退出信号”。

例如：

ctx, cancel := context.WithCancel(context.Background())
go worker(ctx)

// 收到信号后
cancel()

这样每个worker都可以监听这个context是否被取消，并主动退出。

如果你不想用context，也可以自己维护一个done channel：

done := make(chan struct{})
go worker(done)

// 收到信号后
close(done)

选择建议：

• 如果有父子goroutine层级关系，推荐用 context
• 如果只是平级goroutine之间通信，用channel更简单清晰

如何等待所有goroutine完成退出

为了确保所有子goroutine都退出完毕，可以使用 sync.WaitGroup 来做同步控制。

比如：

var wg sync.WaitGroup

for i := 0; i < 3; i++ {
    wg.Add(1)
    go func() {
        defer wg.Done()
        // 工作逻辑
    }()
}

// 等待全部完成
wg.Wait()

结合前面提到的context或done channel，可以在收到信号后先发起退出通知，再调用 WaitGroup.Wait() 来等待清理完成。

一个小细节：如果某个goroutine可能长时间阻塞（比如等网络请求），你最好为它设置超时机制，避免整个程序卡住。

可选：给退出过程加个超时限制

有些情况下，我们不能无限等待所有goroutine退出。这时候可以加一个超时机制，比如：

select {
case <-sigChan:
    // 正常退出流程
case <-time.After(5 * time.Second):
    // 超时，强制退出
    log.Println("timeout waiting for shutdown, force exit")
    os.Exit(1)
}

这种做法可以在优雅与及时之间取得平衡，适合生产环境部署。

基本上就这些。实现优雅关闭的关键点在于：

• 捕获系统信号
• 通知所有goroutine退出
• 同步等待清理完成
• 必要时加上超时保护

这几个环节配合好，就能让Go程序在退出时更加稳健可靠。