Nginx 不参与 WebSocket 帧组装或拆分，仅透传 TCP 数据流；优化核心是关闭 proxy_buffering、禁用 gzip、启用 tcp_nodelay、精准透传 Upgrade 头，并确保后端合规发帧。
WebSocket 协议帧本身由客户端和服务端直接封装与解析，Nginx 作为反向代理**不参与帧的组装或拆分**——它只透传已建立连接上的原始 TCP 数据流。所谓“帧重组”问题，绝大多数并非 Nginx 主动重排帧，而是因配置不当导致帧被截断、延迟下发或边界错乱，表现为消息粘包、丢帧、解析失败等现象。优化核心是让 Nginx 完全“旁路式”转发，避免干预二进制/文本帧结构。
确保帧边界不被缓冲层破坏
Nginx 默认启用响应缓冲（proxy_buffering on），会将后端发来的多个 WebSocket 帧攒在一起发送，或把一个大帧切片缓存，直接破坏帧完整性：
-
必须关闭代理缓冲：在 location 块中设置
proxy_buffering off;，禁用所有响应体缓冲逻辑 -
避免缓冲区大小干扰帧对齐：若因兼容性需保留缓冲（极少数旧版场景），设
proxy_buffer_size 4k;和proxy_buffers 1 4k;，确保最小单位 ≥ 最小可能帧头（2字节）且不跨帧分配 -
禁用 gzip 压缩：WebSocket 帧已含可选 permessage-deflate 压缩，Nginx 的 HTTP 层压缩会覆盖或损坏帧头，务必设
gzip off;
防止 Nagle 算法合并小帧
心跳 Ping/Pong、状态更新等小数据帧若被内核 Nagle 算法攒包，会导致几十毫秒级延迟甚至帧合并，使接收端无法按标准帧格式解析：
-
启用 TCP_NODELAY：在 location 块中添加
tcp_nodelay on;，该指令仅对已升级成功的 WebSocket 连接生效 -
后端同步关闭 Nagle：Node.js 调
socket.setNoDelay(true)；Java Netty 配置ChannelOption.TCP_NODELAY, true；Go net.Conn 设置SetNoDelay(true) -
验证是否生效：用
ss -i dst your-server-ip:port查连接，输出含nodelay字样即启用成功
规避代理层协议降级与头过滤
若 Upgrade 握手失败，连接未真正升级为 WebSocket，后续所有“帧”实际走的是普通 HTTP 长轮询或短连接，根本不存在标准帧结构，自然无法正确重组：
-
强制 HTTP/1.1：
proxy_http_version 1.1;—— WebSocket 升级机制仅定义于 HTTP/1.1 -
精准透传升级头：使用变量
proxy_set_header Upgrade $http_upgrade;（不是固定字符串），并设proxy_set_header Connection "upgrade"; -
拒绝非法请求：加校验
if ($http_upgrade != "websocket") { return 403; }，避免非 WebSocket 请求静默穿透
匹配后端帧处理节奏
即使 Nginx 完全透传，若后端写入帧时未遵守 WebSocket 规范（如未设置 FIN 位、opcode 错误、掩码缺失），或发送速率远超 Nginx TCP 栈处理能力，仍可能触发内核队列溢出、丢包，间接造成帧丢失或重组异常：
- 后端控制单帧大小：避免单帧超过 64KB（默认多数实现限制），大消息应分片（continuation frames）
- 启用 permessage-deflate（可选）：在握手响应头中协商启用，由端到端压缩，不经过 Nginx 解压/再压缩
-
监控 TCP 排队情况：检查
netstat -s | grep -i "retransmit\|full"，高重传或发送队列满说明链路或后端写入过载
