如何实现WebSocket连接的负载均衡 前端配合Nginx进行分流【配置】

各位小伙伴们，大家好呀！看看今天我又给各位带来了什么文章？本文标题是《如何实现WebSocket连接的负载均衡 前端配合Nginx进行分流【配置】》，很明显是关于文章的文章哈哈哈，其中内容主要会涉及到等等，如果能帮到你，觉得很不错的话，欢迎各位多多点评和分享！

Nginx能做WebSocket负载均衡，但必须配置proxy_http_version 1.1、Upgrade/Connection头透传、proxy_read_timeout与proxy_send_timeout延长至86400、禁用缓冲，并依后端状态选择ip_hash或least_conn算法。

直接上结论：Nginx 能做 WebSocket 负载均衡，但前端必须配合「固定连接路径 + 重连策略」，否则连接会随机漂移、消息丢失、甚至触发重连风暴。

为什么 proxy_pass 后 WebSocket 连接会断开或路由错乱

Nginx 默认把每个新请求当作独立 HTTP 请求处理。WebSocket 握手虽是 HTTP 请求，但后续是长连接；若没显式告诉 Nginx “这是要升级的”，它就会按普通 HTTP 代理转发，然后在超时后主动关闭 TCP 连接。

• proxy_http_version 1.1 缺失 → 后端拒绝升级，返回 400 或直接关闭
• Upgrade 和 Connection 头没透传 → 握手失败，浏览器报 ERR_CONNECTION_REFUSED 或卡在 pending
• 没设 proxy_read_timeout → 空闲 60 秒（默认值）后 Nginx 断连，前端看到 close event 且 event.code === 1006

nginx.conf 必须写的 5 个关键配置项

这些不是可选优化，而是 WebSocket 能跑通的底线。漏一个，连接就不可靠。

• proxy_http_version 1.1：强制走 HTTP/1.1，否则不支持 Connection: upgrade
• proxy_set_header Upgrade $http_upgrade：把客户端带的 Upgrade: websocket 原样传给后端
• proxy_set_header Connection "upgrade"：注意是硬编码字符串 "upgrade"，不是 $http_connection（后者可能为空）
• proxy_read_timeout 86400：单位是秒，建议设为 24 小时（86400），避免空闲断连；别用 7d 这种写法，部分旧版 Nginx 不识别
• proxy_send_timeout 86400：和服务端发心跳或延迟推送有关，和 read 对齐更稳妥

upstream 里要不要加 ip_hash？看你的后端是否共享状态

如果后端节点之间**不共享用户连接状态**（比如没用 Redis 存 session 或 connection map），那必须开启会话保持，否则用户发消息时可能被转到没它连接记录的机器上，导致消息发不出。

• 用 ip_hash：简单，但客户端 IP 变化（如走 NAT、移动网络切换）会导致连接重置
• 用 hash $http_sec_websocket_key consistent：更稳定，基于 WebSocket 握手里的唯一 key 做一致性哈希，推荐
• 不用任何 hash，改用 least_conn：仅当后端有全局状态同步机制（如 gowebsocket + Redis）才安全

前端 JavaScript 怎么配合才不掉线

Nginx 层无法解决所有问题。前端必须主动应对连接漂移和瞬时中断。

• WebSocket URL 里**不要拼随机参数**（如 ?t=123），否则每次重连都算新连接，Nginx 可能分到不同后端
• 重连逻辑要加退避（backoff）：第一次 1s，失败后 2s、4s、8s… 避免瞬间几千连接打爆某台 backend
• 发消息前检查 ws.readyState === WebSocket.OPEN，别假定连接一直活着
• 服务端下发消息时带上 msg_id，前端收到后存 localStorage，重连后主动拉取未确认消息（补偿机制）

最易被忽略的一点：Nginx 的 proxy_buffering off 在 WebSocket 场景下几乎无用——它只影响 HTTP 响应体缓存，而 WebSocket 数据走的是原始 TCP 流，不受该指令控制。别在这上面浪费调试时间。

本篇关于《如何实现WebSocket连接的负载均衡 前端配合Nginx进行分流【配置】》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！