Go不支持Nginx式零停机热更新,本质是通过exec.Command启动新进程并继承监听socket文件描述符实现平滑重启,依赖SIGHUP重载配置、USR2触发升级,需精确控制信号时序、fd继承与原子配置切换。

Go 本身不支持像 Nginx 那样零停机 reload 配置+二进制的热更新,但可以通过 exec.Command + os.Signal + 文件锁协同实现「配置热重载」和「平滑重启(graceful restart)」两个关键能力。真正的难点不在代码量,而在信号时序、子进程生命周期和文件描述符继承控制。
用 os/exec 启动新进程并传递监听 socket
核心是让新旧 Go 进程共享同一个监听 socket,避免端口冲突和连接中断。Nginx 做法是父进程 open socket 后 fork 子进程并传递 fd;Go 没有 fork,得靠 exec.Command 启动新进程,并通过环境变量或命令行参数把 listener 的文件描述符传过去。
- 老进程调用
listener.File()获取*os.File,再用file.Fd()得到整数 fd - 用
cmd.ExtraFiles = []*os.File{file}将该 fd 作为第 3 个(即 fd=3)文件描述符传给子进程 - 新进程启动时检查
os.Getenv("LISTEN_FD") == "3",然后用net.FileListener(os.NewFile(3, ""))恢复 listener - 必须在新进程成功绑定 listener 后,老进程才能关闭自己的 listener 和 accept 循环
用 os.Signal 捕获 SIGHUP 和 USR2 区分两类操作
Unix 服务惯例:SIGHUP 用于重载配置,USR2(或 SIGUSR1)用于升级二进制。Go 程序需明确区分二者,不能混用。
-
SIGHUP:只 reload 配置(如 TLS 证书、路由规则),不启新进程,不关闭 listener -
USR2:触发平滑重启流程——启动新进程、等待其就绪、通知其接管 listener、再退出自己 - 务必用
signal.Ignore(syscall.SIGHUP, syscall.SIGUSR2)防止默认行为终止进程 - 接收信号后立即进入非阻塞状态,避免在 signal handler 中做耗时操作(比如读磁盘配置)
配置热重载必须解决原子性与竞态
配置文件变更时,直接 os.Open + json.Unmarshal 会导致中间态不一致(比如 TLS cert 更新一半,HTTP server panic)。不能依赖“先读再赋值”这种直觉做法。
- 使用
atomic.Value存储配置指针,写入前构造完整新配置,再Store()替换,读取时Load()得到的是全量快照 - 监听配置文件变化推荐
fsnotify,但注意:fsnotify.Event.Op&fsnotify.Write != 0不代表写完,要等Chmod或Remove事件才可靠 - 更稳妥的做法是用临时文件写入 +
os.Rename(同一文件系统下是原子的),再触发 reload - reload 失败时,保留旧配置继续服务,打 error 日志,不要 panic 或 exit
子进程就绪判断不能只靠 time.Sleep
常见错误是父进程启动子进程后 sleep 100ms 就发信号,结果子进程还没 bind listener,导致连接被拒绝。必须由子进程主动通知父进程“我已 ready”。
- 子进程启动后,立刻尝试
net.Dial自己的管理端口(如 localhost:9999/healthz),成功即表示 listener 已就绪 - 或者用 Unix domain socket / tmpfile 做 handshake:父进程创建
/tmp/myapp.pid-xxx.ready,子进程写入自身 pid 后删除它,父进程轮询该文件是否存在 - 超时时间建议设为 5s,超过则 kill 子进程并记录 fatal error
- 父进程在发送 USR2 后,必须等待子进程真正接管 listener,才能调用
oldServer.Shutdown()
最易被忽略的是 listener fd 的 close-on-exec 属性:若没设置 syscall.SetCloseOnExec(int(fd), 1),子进程 exec 后仍会继承该 fd,导致新老进程同时 accept 同一 socket,引发不可预测的连接丢弃。这个细节没有日志、不报错,但线上会静默掉量。


















