Golang与Gin框架结合实现优雅重启-Golang-PHP中文网

go 1.8+ 实现 gin 优雅重启需用 http.server.shutdown() 配合 fork/exec 或第三方库如 endless：shutdown() 仅负责优雅关机（拒绝新连接、等待活跃请求完成），不启动新进程；真正无缝重启依赖套接字文件描述符继承，sigusr2 是标准热替换信号，endless 封装了 fork/exec、fd 传递、信号处理等细节，一行代码即可替代 listenandserve 并支持零停机升级。

golang与gin框架结合实现优雅重启

Go 1.8+ 完全不需要第三方库就能实现 Gin 的优雅重启，关键在于用 http.Server 封装路由，并主动监听 SIGUSR2 信号触发子进程启动——但直接手写 fork+exec 容易出错，生产环境更推荐用 fvbock/endless 或 manners 这类久经考验的封装。

为什么 `ctrl+c` 不是优雅重启

按下 Ctrl+C 发送的是 SIGINT，Go 进程默认行为是立即退出，正在处理的请求（比如一个耗时 3 秒的订单接口）会被强制中断，客户端收到 connection reset 或超时。这不是重启，是“拔电源”。真正的优雅重启必须让新进程接管监听套接字，旧进程等所有活跃连接自然结束。

SIGINT 和 SIGTERM 适合关机，不适合重启
SIGUSR2 是 Unix 系统约定的“热替换”信号，endless 和 manners 都监听它
内核层面，监听 socket 的文件描述符（FD）必须在 fork 后由子进程继承，否则新进程无法 bind 到同一端口

`fvbock/endless` 一行替换就生效

它把整个重启逻辑封装成一个 ListenAndServe 替代函数，不用改业务代码结构。启动后，发 kill -USR2 <pid></pid> 就触发新进程启动、旧进程 graceful shutdown。

Golang Samber Hot

在 Golang 中使用 samber/hot 进行内存缓存，支持 LRU、LFU、TinyLFU、W‑TinyLFU、S3FIFO、ARC、TwoQueue、SIEVE、FIFO 等淘汰算法，提供 TTL、缓存加载器及分片功能。

下载

替换前：log.Fatal(http.ListenAndServe(":8080", router))
替换后：log.Fatal(endless.ListenAndServe(":8080", router))
必须设置超时：默认 endless.DefaultHammerTime = 30 * time.Second，超时未退出则强制 kill，防止卡死
注意：Go 1.19+ 默认启用 CGO_ENABLED=1，而 endless 依赖 cgo 做系统调用，交叉编译需显式传 -tags netgo 避免 libc 依赖问题

`http.Server.Shutdown()` 只管关机，不管重启

这是 Go 标准库原生能力，但只解决“优雅关机”，不解决“如何拉起新进程”。你得自己 fork+exec，还要处理 FD 继承、子进程 PID 管理、信号透传、日志重定向等细节——这些正是 endless 已帮你踩过坑的地方。

srv.Shutdown(ctx) 的作用是：拒绝新连接 + 等待已有连接完成 + 关闭 listener，仅此而已
它不会启动新进程，也不会把 socket FD 传给新进程，所以单独用它无法实现“无缝重启”
若硬要自己实现重启，必须用 syscall.ForkExec 或 os/exec.Command，并手动 dup2 socket FD，极易因权限、路径、环境变量缺失导致失败

容易被忽略的两个硬伤

一是长连接（如 WebSocket、SSE）不会被 Shutdown() 自动断开，必须在 ConnState 回调里主动 close；二是 reload 时，Gin 的中间件（比如 JWT token 验证缓存、数据库连接池）不会自动重建，新进程要重新初始化全局状态，否则可能复用旧进程已失效的资源。