平滑重启通过监听系统信号并调用Server.Shutdown()实现，确保正在处理的请求完成后再退出。1. 使用os/signal监听SIGINT/SIGTERM信号；2. 收到信号后触发带超时的server.Shutdown(ctx)；3. 配合context传递取消信号给后台goroutine；4. 设置合理超时并记录日志，结合反向代理健康检查，保障服务优雅关闭。
在Go语言开发的Web服务中，实现平滑重启（graceful shutdown）是保障服务可用性和请求完整性的重要手段。所谓平滑重启，是指当服务收到关闭信号时，不再接受新的请求，但会等待正在处理的请求完成后再安全退出。这对于生产环境中的零停机部署非常关键。
监听系统信号以触发关闭
Go通过 os/signal 包可以监听操作系统信号，比如 SIGTERM（常用于优雅关闭）或 SIGINT（Ctrl+C）。当收到这些信号时，启动关闭流程。
典型做法是使用一个通道来接收信号：
sigChan := make(chan os.Signal, 1)
signal.Notify(sigChan, syscall.SIGINT, syscall.SIGTERM)
立即学习“go语言免费学习笔记（深入）”；
一旦接收到信号，就可以停止服务器监听新连接。
使用 net/http 的 Shutdown 方法
Go 1.8+ 提供了 http.Server 的 Shutdown() 方法，支持优雅关闭。它会关闭所有空闲连接，并等待正在处理的请求完成（最多等待设定的超时时间）。
示例代码结构：
server := &http.Server{
Addr: ":8080",
Handler: router,
}
go func() {
if err := server.ListenAndServe(); err != nil && err != http.ErrServerClosed {
log.Fatal("Server start error:", err)
}
}()
log.Println("Shutting down server...")
ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
defer cancel()
if err := server.Shutdown(ctx); err != nil {
log.Fatal("Server forced to shutdown:", err)
}
log.Println("Server exited gracefully")
结合 HTTP 路由与服务生命周期管理
实际项目中，常结合 gorilla/mux、gin 等框架使用。以 Gin 为例：
r := gin.Default()
r.GET("/hello", func(c *gin.Context) {
time.Sleep(10 * time.Second) // 模拟长请求
c.String(200, "Hello")
})
server := &http.Server{
Addr: ":8080",
Handler: r,
}
其余信号监听与 Shutdown 逻辑保持一致。这样即使在处理耗时请求时收到关闭信号，也能等其完成后再退出。
注意事项与最佳实践
平滑关闭的关键点：
- 设置合理的超时时间，避免等待太久
- 确保所有后台 goroutine 也能响应关闭信号（可通过 context 传递取消）
- 日志记录关闭过程，便于排查问题
- 反向代理（如 Nginx）应配合设置健康检查，避免将请求转发给正在关闭的服务
基本上就这些。只要合理使用 signal 监听和 Server.Shutdown()，就能轻松实现 Web 服务的优雅关闭，不复杂但容易忽略。
