Go 实现热重启 Web 服务方法

Go 中的“热重启”并非真正的进程内热更新，而是一种通过父进程监听信号（如SIGHUP）、利用 syscall.Exec 启动新子进程并复用监听 socket 文件描述符（fd）来实现零停机切换的协作机制；核心难点在于跨进程安全传递和管理 listener fd，避免端口冲突或连接中断，同时需配合 http.Server.Shutdown 完成优雅关闭，并由外部进程管理器（如 systemd）或成熟库（如 endless）统一协调生命周期——忽视 fd 生命周期、超时设置或二进制替换原子性，极易导致服务不可用，因此生产环境强烈推荐交由 systemd 等专业工具接管，而非手写脆弱的信号逻辑。

Go 本身不支持进程内热重启，所谓“热重启”实际是父进程监听信号、启动新子进程、优雅关闭旧子进程的协作机制——关键不在 http.Server 本身，而在进程生命周期控制和 socket 复用。

用 syscall.Exec + 文件描述符传递实现零停机重启

核心思路是：主进程监听 SIGHUP，调用 syscall.Exec 重新执行当前二进制，并把正在监听的 net.Listener 对应的文件描述符（fd）通过环境变量或参数传给新进程；新进程从 fd 恢复 listener，避免重新 bind 端口失败。

• 旧进程必须在调用 syscall.Exec 前完成所有清理，但不能关闭 listener 的 fd——否则新进程无法复用
• 需用 net.FileListener 从 fd 构造新 listener，且新进程启动后要立刻接管连接，否则客户端会收到 Connection refused
• 推荐使用 github.com/fvbock/endless 或 github.com/gin-contrib/graceful 等成熟封装，它们已处理了 fd 传递、父子进程同步、超时等待等细节

用 http.Server.Shutdown 实现优雅关闭（必须配合外部进程管理）

Shutdown 只负责停止接收新连接并等待已有请求完成，它本身不启动新进程，也不监听信号——必须由外部工具（如 systemd、supervisord）或自定义信号 handler 触发。

• 务必设置 ReadTimeout 和 WriteTimeout，否则长连接可能无限阻塞 Shutdown
• 调用 Shutdown 后，http.Server.Serve 会返回 http.ErrServerClosed，此时应退出 goroutine，避免资源泄漏
• 若服务依赖全局状态（如缓存、数据库连接池），需在 Shutdown 前手动清理，否则新进程可能因状态冲突异常

常见错误：直接 fork/exec 但没传递 listener fd

很多初学者尝试用 os.StartProcess 启动新进程，却忘记把 listener 的 fd 传过去，导致新进程 bind 端口时报 address already in use，而旧进程又未退出，形成双实例竞争。

• 错误写法：exec.Command(os.Args[0], os.Args[1:]...) —— 完全没传 fd
• 正确做法：用 cmd.ExtraFiles = []*os.File{listener.(*net.TCPListener).File()}，并在新进程中读取 os.NewFile(uintptr(3), "")
• 注意 fd 编号：标准输入/输出/错误占 0/1/2，第一个额外 fd 默认是 3；不同平台行为一致，但需检查是否被其他库占用

生产环境建议：用 systemd 替代手写热重启逻辑

除非有特殊定制需求，否则更推荐交由 systemd 管理进程生命周期。配置 Restart=on-failure + ExecReload=/bin/kill -s HUP $MAINPID，再配合 Go 中的 Shutdown，即可实现可靠热更新。

• systemd 自动处理进程树、资源回收、日志重定向，比手写信号逻辑更健壮
• 需在 main 函数中注册 signal.Notify 监听 SIGHUP，触发 Shutdown 后调用 os.Exit(0) 让 systemd 启动新实例
• 二进制替换必须原子：先 mv new_binary old_binary，再发信号，避免中间态运行旧代码

真正容易被忽略的是 listener fd 的生命周期管理——它横跨父子进程，既不能提前 close，也不能遗漏 dup；一旦出错，表现就是端口无法复用或连接突然中断。调试时优先检查 lsof -i :PORT 和 strace -p PID -e trace=bind,listen,close。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Go 实现热重启 Web 服务方法》文章吧，也可关注golang学习网公众号了解相关技术文章。