client_max_body_size对WebSocket握手无效，因其仅限制HTTP请求体，而WebSocket握手使用无body的GET请求，依赖Upgrade等请求头完成协议升级。
client_max_body_size 对 WebSocket 初始握手包无效，它不控制 WebSocket 协议升级请求的大小。
为什么 client_max_body_size 不影响 WebSocket 握手
Nginx 的 client_max_body_size 仅作用于 HTTP 请求体（request body），而 WebSocket 升级请求（即 GET /ws HTTP/1.1）在标准实践中不携带请求体。整个握手过程依赖请求头（如 Upgrade: websocket、Sec-WebSocket-Key 等），没有 body，因此该指令完全不生效。
即使客户端异常发送了 body（非标准行为），Nginx 默认会忽略或直接拒绝带 body 的 GET 请求（除非显式开启 underscores_in_headers 或修改默认限制逻辑），但这不是 WebSocket 规范所要求或推荐的场景。
真正影响 WebSocket 握手的 Nginx 配置项
若需控制与 WebSocket 握手相关的请求特征，应关注以下配置：
- client_header_buffer_size：限制单个请求头缓冲区大小（默认 1k）。若自定义 header 过多或过长（如超长 token、嵌套 cookie），可能触发 400 错误。
-
large_client_header_buffers：设置最大请求数和每个 buffer 大小，用于容纳大 header 块（如含大量
Cookie或自定义认证头）。 - client_header_timeout：防止慢速 header 发送导致连接挂起。
- underscores_in_headers off（默认）：避免因 header 名含下划线被静默丢弃，间接影响握手完整性。
如何安全支持大 header 的 WebSocket 握手
若业务确需在 WebSocket 握手中传递大量元数据（例如通过 X-Auth-Data 传加密票据），可按需调大 header 限制：
WebSocket 8.18.2 是该协议规范的一个重要迭代版本，主要优化了连接稳定性与数据传输效率。它通过全双工通信机制，允许客户端与服务器在单一长连接上实时交换数据，大幅降低传统 HTTP 轮询的开销。该版本增强了心跳保活、自动重连及二进制帧传输能力，适用于即时通讯、在线游戏及金融行情推送等低延迟场景，为开发者提供更可靠的实时网络交互基础。
server {
listen 443 ssl;
location /ws {
# 允许稍大的请求头（例如最多 4 个 8KB buffer）
large_client_header_buffers 4 8k;
client_header_buffer_size 2k;
<pre class="brush:php;toolbar:false;"> # 标准 WebSocket 代理设置
proxy_pass http://backend;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
}}
注意：增大 header 缓冲区会略微增加内存占用，且不能替代合理的协议设计——建议将大载荷移至 WebSocket 连接建立后的帧中传输，而非塞进握手头。
验证与排查建议
当 WebSocket 握手失败（如返回 400 Bad Request 或直接断连）时：
- 用
curl -v -H "Upgrade: websocket" -H "Sec-WebSocket-Key: ..." https://example.com/ws模拟握手，观察 Nginx error log 是否出现client intended to send too large chunked body（极少出现）或更常见的client sent invalid header、header too large。 - 检查 Nginx error log 中是否提示
400并附带client sent too large header—— 此时应调整large_client_header_buffers。 - 确认客户端未在 GET 请求中发送 body（Wireshark 或浏览器 DevTools Network → Headers → Request Payload 应为空）。
不复杂但容易忽略：WebSocket 握手是轻量级头部协商，不是数据通道。限制数据体积的工作应在应用层或 WebSocket 帧级完成，Nginx 在这里只做连接透传和基础头部处理。
