go 应用可通过优雅重启实现零停机更新，即使存在活跃 websocket 连接；关键在于新旧服务进程协同：新服务启动监听后，旧服务停止接受新连接并逐步关闭存量 websocket，配合客户端自动重连机制，用户无感知。
go 应用可通过优雅重启实现零停机更新，即使存在活跃 websocket 连接；关键在于新旧服务进程协同：新服务启动监听后，旧服务停止接受新连接并逐步关闭存量 websocket，配合客户端自动重连机制，用户无感知。
在 Go 中实现带 WebSocket 的优雅重启，不能依赖“等待所有连接自然关闭”的被动策略——因为 WebSocket 是长连接，可能持续数小时甚至数天。真正的优雅重启需主动管理生命周期，核心原则是：分离连接生命周期与进程生命周期。
✅ 正确流程（以 facebookgo/grace 或现代替代方案 golang.org/x/sync/errgroup + net/http.Server.Shutdown 为例）
- 新进程启动并监听同一端口（通过文件描述符继承或端口复用，如 SO_REUSEPORT）；
-
旧进程收到信号（如 SIGUSR2）后：
- 调用 http.Server.Close() 停止接受新连接（包括 HTTP 升级请求）；
- 启动连接 draining：对每个活跃 WebSocket 连接，发送 close 帧（code 1001: GoingAway），并设置合理超时（如 30 秒）等待客户端确认关闭；
- 拒绝新的 WebSocket 升级请求（返回 503 Service Unavailable）；
- 客户端必须实现重连逻辑（这是不可省略的一环）：
// 前端示例：指数退避重连
let ws;
function connect() {
ws = new WebSocket("wss://api.example.com/ws");
ws.onclose = (e) => {
if (e.code === 1001 || e.code === 1006) { // GoingAway / Abnormal closure
setTimeout(connect, Math.min(1000 * Math.pow(2, retryCount), 30000));
retryCount++;
}
};
}
connect();
⚠️ 注意事项
- ❌ 不要等待 WebSocket 连接“自然断开”再退出进程——这会导致旧进程无限驻留；
- ✅ 使用 context.WithTimeout 控制 Shutdown() 最大等待时间（推荐 10–60 秒），超时后强制关闭未完成连接；
- ✅ 在 Shutdown() 前，可调用自定义钩子（如保存会话状态到 Redis）确保业务一致性；
- ? 若 WebSocket 承载敏感状态（如游戏帧同步、实时协作），应在重连时携带 session_id 或 last_seq，由新服务恢复上下文。
? 现代实践建议
facebookgo/grace 和 fvbock/endless 已不再维护。推荐使用标准库组合：
WebSocket 8.18.2
下载
WebSocket 8.18.2 是该协议规范的一个重要迭代版本，主要优化了连接稳定性与数据传输效率。它通过全双工通信机制，允许客户端与服务器在单一长连接上实时交换数据，大幅降低传统 HTTP 轮询的开销。该版本增强了心跳保活、自动重连及二进制帧传输能力，适用于即时通讯、在线游戏及金融行情推送等低延迟场景，为开发者提供更可靠的实时网络交互基础。
srv := &http.Server{Addr: ":8080", Handler: mux}
// 启动 goroutine 监听系统信号
go func() {
sig := make(chan os.Signal, 1)
signal.Notify(sig, syscall.SIGTERM, syscall.SIGINT)
<p>总结：WebSocket 本身不阻碍优雅重启，阻碍的是缺乏重连设计的客户端与未设限的连接等待逻辑。将“连接可靠性”交由客户端保障，将“进程可控性”交由服务端 Shutdown 控制，二者结合，即可实现真正平滑、可运维的 Go WebSocket 服务升级。</p>
