根本原因是Nginx默认配置将大二进制WebSocket帧误作HTTP响应处理，导致缓冲、超时及头透传缺失引发截断、延迟或1009错误；需透传Upgrade机制、禁用缓冲与压缩、调大超时并抓包验证。
根本原因不是 WebSocket 协议不支持，而是 Nginx 默认配置把大二进制帧当普通 HTTP 响应处理，缓冲、超时、头透传缺失三者叠加，导致帧被截断、延迟、静默丢弃或直接触发 1009 错误。
确保协议升级完整透传
这是连通的前提，缺一不可：
- 必须设 proxy_http_version 1.1 —— HTTP/1.0 不支持 Upgrade 机制
- proxy_set_header Upgrade $http_upgrade —— 用变量而非硬编码 "websocket"，兼容各类客户端（如嵌入式设备可能发 "myproto"）
- proxy_set_header Connection "upgrade" —— 注意是小写 upgrade、英文双引号；写成 "Upgrade" 或 $connection 会导致 Connection: close
关闭所有缓冲与响应干预
Nginx 若对二进制流做缓存或重写，会破坏帧边界和时序：
- proxy_buffering off —— 防止攒帧再发，造成毫秒级毛刺或粘包
- proxy_buffer_size 4k（仅设最小值，不启用多级缓冲）
- gzip off —— WebSocket 帧不能压缩，否则解码失败
- proxy_set_header X-Accel-Buffering "no" —— 兼容部分 Nginx 版本，强制禁用加速缓冲
调大超时并禁用请求体解析
大二进制帧传输耗时长，Nginx 默认 60 秒超时会直接切断连接：
- proxy_read_timeout 86400（24 小时）—— 覆盖最大空闲或分片上传间隔
- proxy_send_timeout 86400 —— 避免大帧发送中途被中断
- client_max_body_size 0 —— 禁用请求体限制（WebSocket 不走 body 流程）
- client_body_timeout 0 —— 跳过无意义的帧数据读取等待
验证二进制帧是否真正透传
别信日志，用行为和抓包确认：
- 前端执行 ws.send(new Uint8Array([0x01, 0x02, 0xFF]))，检查服务端是否收到原样字节数组
- Wireshark 过滤 websocket，确认 Frame Type 显示 BINARY，Payload 完全一致
- 若返回 400 或立即断连，优先排查 Upgrade/Connection 头是否丢失；若长度错乱或截断，重点查 proxy_buffering 和 proxy_buffer_size
