router.Run()无法优雅停机，因其底层直接调用阻塞式http.ListenAndServe()且不暴露http.Server实例，无法调用Shutdown()；必须显式构造http.Server并配合signal监听、带超时的context.Context及手动关闭所有goroutine和资源。
为什么 router.Run() 无法优雅停机
router.Run() 是 Gin 封装的快捷启动方式，底层直接调用 http.ListenAndServe()，全程阻塞且不暴露 http.Server 实例。一旦进程收到 SIGINT 或 SIGTERM，Go 运行时直接终止，正在处理的请求被 TCP RST 中断，DB 事务未提交、日志未刷盘、子 goroutine 仍在运行——这不是停机，是“断电”。
必须弃用 router.Run()，显式构造 http.Server 才能调用 Shutdown()。
用 http.Server.Shutdown() 配合 signal 实现基础优雅停机
Go 1.8+ 标准库已支持，无需第三方包。核心逻辑三步：启动服务、监听信号、触发关闭。关键细节全在 channel 缓冲和 context 超时上：
- 用
make(chan os.Signal, 1)创建带缓冲的 channel，否则首次Ctr+C可能丢失 - 只监听
syscall.SIGINT和syscall.SIGTERM，SIGHUP等信号会干扰部署流程 -
Shutdown()必须传入带超时的context.Context，例如context.WithTimeout(context.Background(), 10*time.Second)，否则卡死不退出 - 调用
srv.Shutdown(ctx)后，需用select或直接等待其返回，不能紧接着就os.Exit()
示例片段：
立即学习“go语言免费学习笔记（深入）”；
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
srv := &http.Server{Addr: ":8080", Handler: router}
go func() {
if err := srv.ListenAndServe(); err != nil && err != http.ErrServerClosed {
log.Fatalf("listen: %v", err)
}
}()
quit := make(chan os.Signal, 1)
signal.Notify(quit, syscall.SIGINT, syscall.SIGTERM)
<-quit
log.Println("shutting down server")
ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
defer cancel()
if err := srv.Shutdown(ctx); err != nil {
log.Fatalf("server shutdown failed: %v", err)
}
哪些 goroutine 容易被忽略导致进程卡住
Shutdown() 只管理 HTTP 连接层，它不会等你的业务 goroutine。漏掉任一环节，“优雅”就只是假象：
- 数据库连接池未调用
db.Close()，连接持续占用 - Redis client 未执行
Close()，后台心跳 goroutine 仍在跑 - 自定义 ticker（如定时刷新缓存）没监听
ctx.Done()，无限循环 - WebSocket 连接未主动 close，
srv.Shutdown()不会中断长连接 - goroutine 内部用了
time.Sleep()或阻塞 channel 操作，未响应ctx.Done()
所有长期运行的 goroutine 必须显式检查 ctx.Done() 并退出，否则进程 hang 在那里，Shutdown() 返回后仍不退出。
重启不是 Shutdown + Start，而是进程级替换
所谓“优雅重启”，本质是新进程启动、旧进程 graceful shutdown 后退出。没有真正的“热 reload”——Go 不支持运行时替换代码。
- 用
fvbock/endless是 fork 新进程 + 传递 listener fd，但已多年未维护，且不兼容现代 Unix 域 socket 和 systemd -
manners和grace同样过时，社区已转向进程管理器方案 - 生产环境推荐用
systemd（配置Restart=always+KillSignal=SIGTERM）或容器编排工具（K8s 的 readinessProbe + preStop hook） - 若需开发期快速重启，用
air或reflex监听文件变化并 kill + restart 进程，而非试图在单进程内“重启”
真正需要关注的，是 shutdown 流程是否完整：HTTP 连接、DB、Redis、ticker、WebSocket —— 每一项都得自己收尾。没人替你兜底。
