golang如何实现优雅关机_golang优雅关机graceful shutdown实现方法-Golang-PHP中文网

必须用 http.server.shutdown() 配合带超时的 context.context 才算优雅关机；server.close() 会立即关闭监听器并强制中断所有连接，而 shutdown() 先拒新连、再等待存量请求自然完成或超时。

golang如何实现优雅关机_golang优雅关机graceful shutdown实现方法

必须用 http.Server.Shutdown() 配合带超时的 context.Context，否则不是优雅关机，是强行杀进程。

为什么 `server.Close()` 不行

它会立刻关闭监听器，并强制中断所有活跃连接——大文件上传中断、长轮询断开、流式响应被截断，客户端收到 connection reset。这不是“等请求做完”，是“不管你在干啥，现在就停”。Shutdown() 才是标准解法：先拒新连，再等存量请求自然返回（或超时）。

server.Close() 是底层 socket 级关闭，无等待逻辑
Shutdown() 内部调用 srv.closeListenerConn() 拒绝新连接，再遍历并等待 active conn
若 handler 里有没传 ctx 的阻塞调用（如 http.DefaultClient.Do(req)），Shutdown() 会卡住直到超时

如何正确监听 `SIGTERM` 并触发 `Shutdown()`

线上环境发的是 SIGTERM，不是 SIGINT；且信号通道必须带缓冲，否则快速连发两次可能丢一次。

用 make(chan os.Signal, 1) 创建缓冲通道，避免信号丢失
signal.Notify(sigChan, syscall.SIGINT, syscall.SIGTERM) 显式列出信号，别用 os.Interrupt
收到信号后，立即启动 Shutdown()，不要在 signal handler 里做耗时操作
主 goroutine 必须阻塞等待 Shutdown() 完成，否则进程提前退出

示例关键片段：

Golang Naming

Go（Golang）命名规范 — 包括包、构造函数、结构体、接口、常量、枚举、错误、布尔值、接收器、getter/setter、函数等。

下载

sigChan := make(chan os.Signal, 1)
signal.Notify(sigChan, syscall.SIGINT, syscall.SIGTERM)
ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
defer cancel()
if err := srv.Shutdown(ctx); err != nil {
log.Printf("shutdown error: %v", err) // 注意：err 可能是 context.DeadlineExceeded
}

为什么 `Shutdown()` 总是超时失败

不是函数有问题，是你没管住 handler 里的“不守规矩”操作。它只等连接上的 handler 返回，不杀 goroutine，也不设 I/O 超时。

没设 srv.ReadTimeout / WriteTimeout，挂起连接永远不结束
handler 中用了 time.Sleep(5 * time.Second) 而非 select { case
第三方调用没传 req.Context()：比如 db.QueryRow("...") 应为 db.QueryRowContext(req.Context(), "...")
起了无 context 约束的 goroutine：go sendToKafka(data) → 改为 go func() { select { case

多个组件共存时怎么统一关机顺序

HTTP server、gRPC server、redis.Client、定时器、后台 worker —— 它们不会自动跟着 Shutdown() 关。必须手动按依赖顺序清理，且只能执行一次。

全局只注册一次 signal.Notify，用 sync.Once 包裹 shutdown 主逻辑
关机顺序建议：停新入口（HTTP/gRPC listener）→ 停任务分发（暂停消费者、关定时器）→ 等 handler 自然退出 → 关资源（redis.Close()、db.Close()）
切忌先 db.Close() 再等 HTTP handler，否则 handler 里查库 panic
K8s 场景下，terminationGracePeriodSeconds 必须 ≥ 代码中 context.WithTimeout 设的值，否则 K8s 强杀前 cleanup 没跑完