websocket无统一最大传输长度，实际受限于协议层（rfc 6455理论支持2⁶⁴−1字节但不保证实现）、框架层（如netty默认10mb、tomcat文本缓冲默认8kb）、代理层（nginx默认36kb、cloudflare免费版硬限10mb）及客户端（chrome实测超113kb易重置），超限直接关闭连接而非静默截断。
WebSocket 没有统一的“最大传输长度”，实际限制由协议层、框架层、代理层和客户端四重叠加决定，超限直接触发连接关闭或 TooLongFrameException 等错误，不是静默截断。
WebSocket 协议本身只规定帧头编码能力，不保证可用
RFC 6455 允许用 64 位字段表示 payload 长度，理论支持到 2⁶⁴−1 字节（约 1.8 × 10¹⁹ 字节），但这仅是编码上限，不是实现保障。真实世界中：
- 长度 ≥ 126 时，帧头需扩展：126 表示后 2 字节存长度，127 表示后 8 字节存长度——手写 WebSocket 帧时若错用
(byte)126传 65536+ 字节，会因字节溢出导致连接中断 - 协议未定义超长帧的恢复逻辑，也未强制要求分片由哪端发起，所以不同浏览器/服务端对同一超长消息行为可能不一致
- Chrome 当前（2026 年）对单帧仍存在隐式限制，实测超过 ~113KB 二进制帧易触发
net::ERR_CONNECTION_RESET
Netty / Spring WebFlux 的 maxFramePayloadLength 是关键开关
这是服务端最先拦截超长帧的地方，多数默认值远低于协议上限：
WebSocket 8.18.2
下载
WebSocket 8.18.2 是该协议规范的一个重要迭代版本，主要优化了连接稳定性与数据传输效率。它通过全双工通信机制，允许客户端与服务器在单一长连接上实时交换数据，大幅降低传统 HTTP 轮询的开销。该版本增强了心跳保活、自动重连及二进制帧传输能力，适用于即时通讯、在线游戏及金融行情推送等低延迟场景，为开发者提供更可靠的实时网络交互基础。
-
WebSocketServerProtocolHandler构造时未传参，默认为10 * 1024 * 1024（10MB），超长直接抛TooLongFrameException并 close 连接 - Spring WebFlux 中
WebSession.setMaxMessageSize()设为 64MB 无效，若底层 Reactor Netty 的maxFramePayloadLength仍是 10MB，照样被拦 - 正确写法（Netty）：
pipeline.addLast(new WebSocketServerProtocolHandler("/ws", "", true, 100 * 1024 * 1024));
Tomcat 和 SuperSocket 的配置项名称完全不同但作用相似
传统 Servlet 容器和 .NET 生态 WebSocket 库各自维护独立缓冲区参数，不共享 Netty 设置：
- Tomcat：必须在
web.xml中设<param-name>org.apache.tomcat.websocket.textBufferSize</param-name>，否则文本消息 >8KB 就失败；二进制用binaryBufferSize参数 - SuperSocket.WebSocket：
ServerConfig.MaxRequestLength默认 1024 字节，不是指接收缓冲区大小，而是单次解析请求的最大有效载荷长度，设为1024 * 1024才能收 1MB 消息 - Jetty：需在 WebSocketServletFactory 中调用
setIdleTimeout()和setMaxBinaryMessageSize()，后者才是真·长度开关
Nginx 和 Cloudflare 会在 upgrade 后继续掐帧
反向代理不只管 HTTP 请求体，WebSocket 帧流经过时仍受其缓冲区约束：
- Nginx 默认
proxy_buffer_size 4k，proxy_buffers 8 4k，合计最多缓 36KB 帧数据；超限返回 502 或静默断连 - 必须显式加大：
proxy_buffer_size 128k;<br>proxy_buffers 16 128k;<br>client_max_body_size 100m;
注意client_max_body_size控的是 upgrade 请求头大小，不是后续帧 - Cloudflare 免费版硬性限制 WebSocket 单消息 ≤10MB，且无配置入口；企业版可提工单调整，但 TLS 握手阶段就可能因证书链或 ALPN 不匹配提前拒绝
真正难处理的不是“设哪个参数”，而是**各层限制相互遮蔽**：比如你调大了 Netty 的 maxFramePayloadLength，但 Nginx 缓冲区没跟上，前端看到的错误日志里根本不会提 Nginx，只会显示连接异常关闭——得逐层加日志或抓包确认帧在哪一层被截断。
