Golang Web服务如何优雅关闭_Golang服务平滑退出方案_网络技术

Golang Web服务如何优雅关闭_Golang服务平滑退出方案

发布时间 - 2026-02-02 00:00:00 点击率：次

必须用带超时的server.Shutdown()实现优雅关闭：先拒新连，再等待存量请求完成或超时，最后释放资源；Close()会强杀连接，Shutdown不带超时则可能永久阻塞。

为什么不能直接用 `server.Close()`？

因为 server.Close() 会立刻关闭 listener，所有新连接被拒，**已接受但尚未写响应的请求也会被强制断开**——客户端大概率收到 connection reset 或空响应，相当于“拔电源”。这不是优雅，是强杀。

本地 Ctrl+C 或 kill -2 发的是 SIGINT，K8s、systemd、Docker 默认发 SIGTERM；只监听一个，上线后就关不掉
SIGKILL（kill -9）无法捕获，也不该处理，别白费劲
没配超时的 server.Shutdown(context.Background()) 可能永久卡住——比如 handler 里写了 select{} 或阻塞 channel

必须用 `server.Shutdown()` 配超时 context

Shutdown() 是 Go 1.8+ 官方定义的唯一优雅路径：它先拒新连、再等存量连接自然退出（或超时）、最后释放资源。但必须带 deadline，否则等于没设保险。

超时时间不是越长越好：设 5 秒还是 30 秒，取决于你最长请求的合理耗时；太短 → 强制中断；太长 → CI/CD 卡住、平台强杀
srv.ListenAndServe() 不能放在 main 协程里——它会阻塞，后续信号监听和 Shutdown() 根本没机会执行
启动服务必须用 go srv.ListenAndServe()，然后主 goroutine 留给信号监听和关闭逻辑

真实可运行的最小闭环示例

以下代码去掉注释就能跑，覆盖开发（SIGINT）和生产（SIGTERM）两种信号，且含超时兜底：

package main

import ( "context" "log" "net/http" "os" "os/signal" "syscall" "time" )

func main() { mu

x := http.NewServeMux() mux.HandleFunc("/", func(w http.ResponseWriter, r http.Request) { time.Sleep(2 time.Second) // 模拟业务 w.Write([]byte("OK")) })

srv := &http.Server{Addr: ":8080", Handler: mux}

// 启动服务（非阻塞）
go func() {
    log.Println("Server starting on :8080")
    if err := srv.ListenAndServe(); err != nil && err != http.ErrServerClosed {
        log.Fatal(err)
    }
}()

// 监听信号
quit := make(chan os.Signal, 1)
signal.Notify(quit, os.Interrupt, syscall.SIGTERM)

<-quit
log.Println("Received shutdown signal")

// 带超时的 Shutdown
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()

if err := srv.Shutdown(ctx); err != nil {
    log.Fatal("Server shutdown error:", err)
}
log.Println("Server exited gracefully")

}