http.Server.Shutdown 是唯一靠谱的优雅停机方式，因其先关闭监听器再等待已有连接完成，避免中断处理中的请求；而 Close 会立即断开所有连接，导致客户端收到不完整响应。
为什么 http.Server.Shutdown 是唯一靠谱的选择
直接调用 http.Server.Close 会立刻断开所有连接，正在处理的请求被中断，返回 http.ErrServerClosed，客户端收到不完整响应。而 Shutdown 会先关闭监听器，再等待已有连接完成（含长连接、流式响应），是 Go 官方明确推荐的优雅停机方式。
关键点：它必须在收到信号后**立即调用**，且不能和 ListenAndServe 并发竞争 —— 否则可能 panic 或漏掉信号。
-
Shutdown不会主动 kill 连接，只设超时；超时后未结束的连接会被强制关闭 - 必须传入非 nil 的
context.Context，否则阻塞等待（比如用context.WithTimeout(ctx, 10*time.Second)） - 调用前确保没有新连接能进入（即已调用
server.Close或监听器已关闭）——但Shutdown内部自动处理这点，你不用手动关监听器
如何安全捕获 SIGTERM / SIGINT 并触发 Shutdown
Go 的 os.Signal 机制容易出错：信号 channel 没缓冲、select 漏写 default、或在 goroutine 中重复监听同一信号 —— 导致信号丢失或程序卡死。
正确做法是用带缓冲的 channel（容量 1），并在主 goroutine 中阻塞等待，同时确保 Shutdown 只执行一次。
- 用
signal.Notify(sigChan, syscall.SIGTERM, syscall.SIGINT)，别漏掉SIGINT（Ctrl+C） - 启动 HTTP server 用
go server.ListenAndServe()，别阻塞主线程 - 在 select 中监听
sigChan和ctx.Done()（如果用了 context 控制生命周期） - 收到信号后，调用
server.Shutdown前，先关闭自定义资源（如数据库连接池、消息队列消费者），避免 shutdown 期间还在写数据
Graceful shutdown 里最容易被忽略的三件事
很多人以为调了 Shutdown 就万事大吉，结果线上服务仍出现 502、连接重置或数据丢失 —— 问题往往出在周边环节。
Go语言（Golang）1.26.0
下载
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- HTTP handler 里有阻塞操作（比如没设 timeout 的
http.Client.Do或time.Sleep）：这些不会被Shutdown中断，必须自己加 context 控制 - 使用了第三方中间件（如
gorilla/mux、chi）：它们不改变底层 server 行为，但若你在 middleware 里启了后台 goroutine（如日志 flush），要单独管理其生命周期 - 没检查
Shutdown返回 error：它返回非 nil error 仅表示超时或上下文取消，但此时 server 已不可用，必须退出进程，不能忽略
一个最小可运行的优雅停机示例
下面代码去掉注释就能跑，重点看 signal 处理、shutdown 超时、以及 handler 中如何响应 cancel：
func main() {
srv := &http.Server{Addr: ":8080", Handler: http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
// 避免 handler 阻塞 shutdown
select {
case done := make(chan os.Signal, 1)
signal.Notify(done, syscall.SIGINT, syscall.SIGTERM)
go func() {
if err := srv.ListenAndServe(); err != http.ErrServerClosed {
log.Fatalf("server failed: %v", err)
}
}()
sig := <p>}</p>
注意：handler 里用了 r.Context().Done()，这样当 shutdown 开始、连接被关闭时，request context 会 cancel，handler 能及时退出 —— 这是让整个链路真正“优雅”的关键一环。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
