Go微服务平滑升级必须依赖老进程移交监听器FD给新进程，仅调用http.Server.Shutdown()会中断流量，因其只停止接收新连接、等待活跃请求结束、释放监听socket，但不启动新进程、不传递FD、不解决端口复用，单独使用必然导致空窗期或502错误。
Go 微服务平滑升级不是靠“重启”实现的，而是靠老进程移交监听器 FD 给新进程。单独调用 http.Server.Shutdown() 会中断流量，os.Exit(0) 更是直接断连——必须配合进程间 socket 传递，否则必然出现 address already in use 或网关返回 502。
为什么 Shutdown() 单独调用不能平滑升级
http.Server.Shutdown() 只做三件事：停止接受新连接、等待活跃请求结束、释放监听 socket。它不启动新进程，也不传递 FD，更不解决端口复用问题。如果在 Shutdown() 返回后立刻 os.Exit(0)，就会出现服务空窗期。
- 超时时间设太短（如
5s），WebSocket 或流式响应会被强制中断 -
Shutdown()返回后，DB 连接池、Redis client、日志文件句柄仍可能未关闭，进程卡在WaitForProcess - 没等新进程真正
server.Serve()开始接收连接就退出老进程，流量直接丢失
如何用 SIGUSR2 + net.Listener.File() 传递监听器
Linux 下标准做法是老进程收到 SIGUSR2 后提取监听器 FD，通过 exec.Command().ExtraFiles 传给子进程，子进程用 net.FileListener() 复原——不是写临时文件，也不是读环境变量。
- 老进程中：确保 listener 是
*net.TCPListener类型，调ln.(*net.TCPListener).File()得到*os.File，其Fd()通常是3 - 启动子进程时：
cmd.ExtraFiles = []*os.File{file}，子进程就能按顺序拿到 fd=3 - 子进程中：用
os.NewFile(3, "")→net.FileListener(file)，注意http.Server.Addr必须为空字符串""，否则server.Serve()会尝试重新 bind - 务必检查
listener.Addr()是否与原始地址一致，否则可能绑定到随机端口
Kubernetes 场景下别自己 fork 子进程
容器内进程通常不是 PID 1，SIGUSR2 会被 sh 或 init 拦截；FD 传递在容器命名空间中受限，net.FileListener() 极易返回 invalid argument。硬编码自重启在 K8s 里基本不可用。
立即学习“go语言免费学习笔记（深入）”；
- 正确路径是更新
Deployment.spec.template.spec.containers[].image，让 kubelet 拉起全新 Pod -
readinessProbe必须真实反映监听器就绪状态（例如 GET/healthz返回200），且 probe 要等server.Serve()真正开始接受连接后再成功 -
preStophook 中执行kill -TERM $PID（不是USR2），触发 Go 进程内部的Shutdown()流程
最容易被忽略的是：新进程是否真正在监听、老进程是否真等到新进程就绪才退出、FD 传递失败时有没有 fallback 日志。这些点不验证，上线就踩坑。
