Go微服务平滑下线需完整链路：信号捕获（仅SIGTERM/SIGINT、主goroutine单次注册）、分层关闭（HTTP用带超时context的Shutdown、gRPC用GracefulStop）、反注册（Consul等在Shutdown后执行）、goroutine协同退出（统一ctx.Done监听+WaitGroup）。
Go 微服务平滑下线不是“调个 Shutdown() 就完事”，而是信号捕获、分层关闭、反注册、goroutine 协同退出的完整链路。跳过任意一环，就会出现幽灵实例、连接 RST、重复消费或请求丢失。
signal.Notify 必须只监听 SIGTERM 和 SIGINT 一次
K8s preStop 默认发 SIGTERM，本地调试用 Ctrl+C 是 SIGINT。漏掉任一个，服务在对应场景下就完全不响应下线信号。
-
signal.Notify必须在主 goroutine 里调用且只调一次；重复注册会导致 channel 阻塞或信号丢失 - 不要用
os.Interrupt替代syscall.SIGINT——前者在某些容器环境不生效 - channel 缓冲区大小设为 1 即可：
sigChan := make(chan os.Signal, 1)；缓冲太大可能积压多个信号，导致多次触发 shutdown - 监听后必须显式读取：
，否则主 goroutine 退出，信号无处落脚
http.Server.Shutdown() 必须带超时 context 且放 goroutine 里执行
Shutdown() 是阻塞调用，不加超时会卡死，不放 goroutine 里则后续所有清理逻辑（gRPC 关闭、DB 反注册）根本不会执行。
- 超时 context 正确写法：
ctx, cancel := context.WithTimeout(context.Background(), 15*time.Second)；不能用context.Background()或context.TODO() -
cancel()不能 defer：否则刚建完 context 就被取消，Shutdown()立刻返回context.Canceled - 必须检查返回 error：
err != nil && err != http.ErrServerClosed才需 log；http.ErrServerClosed是正常退出信号，不是错误 -
Shutdown()不等 handler 主动退出——它只停止 accept、等待连接自然结束；handler 内部必须响应req.Context().Done()
gRPC Server 必须用 GracefulStop()，不能用 Stop()
Stop() 等价于 kill -9，会立刻断开所有连接；GracefulStop() 才是真正等待已有请求完成的优雅方式。
-
GracefulStop()本身不设超时，必须靠外层 context 控制整体时限：先ctx, cancel := context.WithTimeout(...)，再grpcServer.GracefulStop() - HTTP 和 gRPC server 关闭顺序有讲究：建议先
GracefulStop()（拒绝新 RPC），再Shutdown()（停 HTTP 健康探针），避免流量还在打健康检查但业务已不可用 - gRPC 客户端连接池（如
grpc.Dial创建的）也要关：conn.Close()，否则 fd 泄漏 - 若服务同时暴露 HTTP 和 gRPC，别各自为政——用同一个超时 context 驱动整个关闭序列
后台 goroutine 和依赖组件必须显式退出
Shutdown() 和 GracefulStop() 都不管你的后台 goroutine。它们不退出，进程就停不下来，资源持续泄漏。
- 所有长期运行 goroutine（Kafka 消费者、定时任务、心跳上报）必须监听统一
ctx.Done()，用select { case ，不能只轮询if ctx.Err() != nil - 用
sync.WaitGroup管理 goroutine 生命周期：启动前wg.Add(1)，退出前wg.Done()；Shutdown()返回后、os.Exit(0)前调wg.Wait() -
*sql.DB.Close()是阻塞的，但它只等 idle 连接归还，不等正在执行的 query —— 所以必须确保所有 handler 已进入 shutdown 流程，不再发起新 query - Consul 反注册必须在
Shutdown()返回之后、os.Exit(0)之前执行；早了流量断，晚了进程已死，注册中心仍认为服务在线
最常被忽略的点是 handler 内部对 req.Context().Done() 的响应——哪怕 Shutdown() 设置了 30 秒超时，一个没检查上下文的上传 handler 也可能卡满全程，拖垮整个下线流程。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
