Go语言无框架自动优雅停机，必须手动用http.Server.Shutdown()配合信号监听、带超时context.Context，并显式关闭gRPC/DB/Redis等所有资源；router.Run()因封装ListenAndServe()且不暴露Server实例而无法实现。
Go 语言没有框架能自动帮你完成优雅停机——所有“优雅”都来自你对 http.Server.Shutdown()、信号监听、context 超时和资源关闭顺序的手动控制。用 Gin、Echo 或 Fiber 不改变这个事实，它们只是封装了路由，没封装 shutdown 流程。
为什么 router.Run() 无法优雅停机
Gin 的 router.Run()、Echo 的 e.Start()、Fiber 的 app.Listen() 都是阻塞调用，内部直接调 http.ListenAndServe()。一旦进程收到 SIGTERM，Go 运行时默认退出，不等待任何 handler 返回，也不关数据库或 Redis 连接。
- 现象：Ctrl+C 后日志戛然而止，
defer没执行，db.Close()被跳过 - 本质：你把控制权交给了黑盒启动函数，失去了对
http.Server实例的引用，也就没法调Shutdown() - 解法：必须显式构造
*http.Server，自己启 goroutine 跑ListenAndServe()，保留实例用于后续 shutdown
shutdown() 必须带超时 context，且不能传 context.Background()
http.Server.Shutdown() 本身不设超时，它只做两件事：拒绝新连接 + 等所有正在执行的 handler 返回。如果某个 handler 卡在没设 deadline 的 db.Query()、redis.Client.Get() 或 select{} 上，它就永远等下去。
- 错误写法：
srv.Shutdown(context.Background())→ 进程 hang 住，K8s 在 terminationGracePeriodSeconds 后发SIGKILL - 正确写法：
ctx, cancel := context.WithTimeout(context.Background(), 25*time.Second)；defer cancel()；srv.Shutdown(ctx) - 超时值建议：比业务 P99 延迟高 5–10 秒，但必须小于 K8s 的
terminationGracePeriodSeconds（如后者是 30s，这里设 25s）
HTTP 之外的资源必须手动关，且顺序不能错
http.Server.Shutdown() 只管 HTTP 连接层。gRPC、DB、Redis、WebSocket、定时器、消息消费者……全得你自己收尾，漏一个，main 函数就卡在 select 或 sync.WaitGroup.Wait() 里不退出。
立即学习“go语言免费学习笔记（深入）”；
- gRPC Server：用
grpcServer.GracefulStop()（不是Stop()），但它不等流式 RPC 结束，需额外加逻辑判断活跃 stream 数 - 数据库：
db.Close()会阻塞直到所有连接归还，但它不中断活跃事务——你的 handler 必须用db.QueryContext(ctx, ...)，否则Close()白等 - Redis client：
client.Close()是必须的，否则底层 TCP 连接不释放，进程无法退出 - 后台 goroutine：所有
time.Ticker、消息循环必须在select中监听ctx.Done()，不能只轮询ctx.Err()（会忙等）
K8s 环境下信号转发和容器启动命令是隐形陷阱
K8s 发 SIGTERM 给容器 PID 1 进程。如果你的容器 command 是 ["sh", "-c", "./myapp"]，那 shell 是 PID 1，它默认不转发信号给子进程——你的 Go 程序根本收不到 SIGTERM。
- 必须检查 Dockerfile：用
ENTRYPOINT ["./myapp"]或CMD ["./myapp"]，确保 Go 二进制是 PID 1 - signal channel 必须带缓冲：
sigChan := make(chan os.Signal, 1)，否则并发发多个信号可能丢第一个 - 只监听
os.Interrupt和syscall.SIGTERM，别加SIGHUP或SIGQUIT——无关信号可能干扰 shutdown 流程
真正难的从来不是写几行 Shutdown()，而是让每个 handler、每个 client、每个 goroutine 都尊重同一个 ctx，并在 ctx.Done() 到来时真正停下来。这需要从第一行业务代码开始设计，而不是在 main 函数里补个 shutdown 调用。
