本文介绍在 go 中实现优雅退出（graceful shutdown）的正确方式，包括监听系统信号、执行清理逻辑、避免资源泄漏，并给出可直接使用的完整示例代码。
本文介绍在 go 中实现优雅退出（graceful shutdown）的正确方式，包括监听系统信号、执行清理逻辑、避免资源泄漏，并给出可直接使用的完整示例代码。
在生产环境中，简单使用 kill {pid}（不带 -9）终止 Go 进程虽能触发默认退出流程，但若服务持有数据库连接、HTTP 服务器、goroutine 工作池或文件句柄等资源，粗暴终止可能导致数据丢失、连接中断或资源泄露。真正的“优雅退出”是指：进程在收到终止信号后，主动暂停接收新请求，完成正在处理的任务，释放关键资源，再安全退出。
Go 提供了 os/signal 包支持对操作系统信号的监听与响应。最常用的是 SIGINT（Ctrl+C 触发）和 SIGTERM（kill {pid} 默认发送），二者均应被纳入监听范围。以下是一个轻量但完整的优雅退出实现：
package main
import (
"fmt"
"net/http"
"os"
"os/signal"
"syscall"
"time"
)
func main() {
// 启动 HTTP 服务器作为典型长期运行服务
server := &http.Server{Addr: ":8080"}
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
fmt.Fprintf(w, "Hello, graceful shutdown demo!")
})
go func() {
fmt.Println("Server starting on :8080")
if err := server.ListenAndServe(); err != http.ErrServerClosed {
fmt.Printf("Server error: %v\n", err)
}
}()
// 启动优雅关闭监听器
gracefulShutdown(server)
// 阻塞主 goroutine，防止程序立即退出
select {}
}
func gracefulShutdown(server *http.Server) {
sigChan := make(chan os.Signal, 1)
signal.Notify(sigChan, os.Interrupt, syscall.SIGTERM)
<-sigChan // 等待首个终止信号
fmt.Println("Received shutdown signal. Shutting down gracefully...")
// 执行自定义清理逻辑（如关闭数据库连接、保存状态等）
// 示例：模拟清理耗时操作
fmt.Println("Performing cleanup...")
time.Sleep(500 * time.Millisecond) // 占位，实际替换为真实清理逻辑
// 关闭 HTTP 服务器（支持超时控制，避免无限等待）
ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
defer cancel()
if err := server.Shutdown(ctx); err != nil {
fmt.Printf("Server shutdown error: %v\n", err)
} else {
fmt.Println("HTTP server shut down successfully.")
}
os.Exit(0)
}⚠️ 注意事项：
- 必须导入 context 包：server.Shutdown() 需要 context.Context 参数，用于设定最大等待时间，防止因长连接阻塞而永久挂起；
- 避免 os.Exit(0) 过早调用：确保所有清理逻辑（如 db.Close()、pool.Stop()）执行完毕后再退出；
- 不要在 main() 中直接 os.Exit()：应由信号处理 goroutine 统一控制退出时机；
- 生产部署建议配合进程管理器：如 systemd、supervisord 或容器编排工具（如 Kubernetes），它们默认发送 SIGTERM 并支持配置 terminationGracePeriodSeconds，与 Go 的优雅退出机制天然契合；
- 测试验证：可通过 kill $(pidof your-binary) 或 Ctrl+C 触发，观察日志是否输出 “Shutting down gracefully…” 及后续清理信息。
总结而言，优雅退出不是“要不要做”的选择题，而是现代服务的必备实践。它提升系统稳定性、保障数据一致性，并为无缝滚动更新（rolling update）奠定基础。从今天起，为你的每个长期运行 Go 服务添加信号监听与资源清理逻辑——这行之有效的几行代码，正是专业级服务的起点。
