必须配合信号监听和带超时的context.context调用http.server.shutdown()，否则无法触发退出、请求被粗暴中断、连接重置；shutdown()本身不监听信号、不设超时、不管理goroutine生命周期，需手动桥接信号、控制等待窗口、同步关闭依赖组件。
为什么 http.Server.Shutdown() 不能直接调用就完事
直接在程序退出前调用 srv.Shutdown(ctx) 而不配合信号监听或上下文控制，会导致请求被粗暴中断——正在处理的 HTTP 请求可能返回 503 或直接断连，客户端收不到完整响应。Go 的 http.Server 本身不自动监听 OS 信号，也不管理上下文生命周期，必须手动桥接。
常见错误现象：context.DeadlineExceeded 频繁出现、部分请求响应体缺失、gRPC 连接复位（transport is closing）。
- 必须用
context.WithTimeout()给Shutdown()设定合理等待窗口（通常 5–30 秒），太短丢请求，太长拖住进程 -
Shutdown()是阻塞调用，需确保它不在主 goroutine 中阻塞整个退出流程（比如没用 goroutine 包裹） - 若服务还启用了
http2.Server或自定义 TLS 配置，需确认 Go 版本 ≥ 1.8（Shutdown()原生支持）且未禁用 HTTP/2
如何用 os.Signal 和 sync.WaitGroup 协同完成平滑关闭
优雅关闭的本质是：收到终止信号 → 拒绝新连接 → 完成存量请求 → 关闭监听器 → 清理资源。这需要信号捕获、连接计数、超时控制三者联动。
典型使用场景：部署在 Kubernetes 中的 Go Web 服务，需响应 SIGTERM；或 CLI 工具中按 Ctrl+C 退出。
- 用
signal.Notify(sigChan, syscall.SIGTERM, syscall.SIGINT)监听信号，避免直接用os.Interrupt（Windows 不兼容） - 用
sync.WaitGroup跟踪活跃 HTTP handler goroutine（在每个 handler 开头wg.Add(1)，结尾wg.Done()），但注意别在中间 panic 时漏掉Done() - 启动
Shutdown()前，先调用srv.Close()是错的——它会立即关闭 listener，新请求进不来但旧请求还在跑，Shutdown()反而无法正常等待它们结束
Shutdown() 超时后仍有 goroutine 残留怎么办
即使 Shutdown() 返回，也可能存在后台 goroutine（如日志 flush、metrics 上报、数据库连接池 close）未结束，导致进程 hang 住。这不是 Shutdown() 的问题，而是资源清理没跟上。
性能与兼容性影响：Go 1.21+ 对 net/http 的连接追踪更精细，但自定义 http.Transport 或第三方中间件（如 promhttp）可能绕过标准生命周期管理。
- 所有长周期 goroutine 必须接收同一个
ctx（来自context.WithCancel()），并在select { case 中响应取消 - 数据库连接池用
db.Close()（不是db.Ping()），它会等空闲连接归还后再关闭；若设了SetConnMaxLifetime，需预留足够时间让连接自然过期 - 若用了
pprof或expvar，它们默认不响应 shutdown，需自行注册 cleanup 函数（如http.DefaultServeMux.Handle("/debug/pprof/", nil)）
HTTP/2 和 gRPC over HTTP/2 的关闭差异
HTTP/2 连接复用特性会让单个 TCP 连接承载多个请求流，Shutdown() 默认只等「已接受但未完成」的请求，不会主动 reset 活跃 stream。gRPC 客户端若没设置 WithBlock() 或超时，可能卡在 Connect()。
容易踩的坑：在 gRPC Server 上只调用 grpcServer.GracefulStop() 而忽略底层 http.Server 的 Shutdown()，会导致 listener 端口残留；反之亦然。
- gRPC Server 必须用
GracefulStop()（非Stop()），它内部会等待 stream 结束并发送 GOAWAY 帧 - 若同时暴露 HTTP/1.1 和 gRPC（同一端口），需用
grpc.HTTP2ServerOption配合http.Server.Handler，且Shutdown()必须在GracefulStop()完成后再调用 - 客户端侧要设
grpc.WithTimeout()和grpc.FailOnNonTempDialError(true)，避免因服务端关闭时连接抖动而无限重试
Close(context.Context) error 方法的结构体，统一由主 shutdown 流程驱动。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
