Nginx代理WebSocket出现“毛刺”的根本原因是默认HTTP缓冲与流式帧传输冲突，需关闭proxy_buffering、禁用gzip、设proxy_http_version 1.1、禁用请求体解析，并调优TCP参数及规避CDN干扰。
WebSocket长连接在Node环境下经Nginx代理后出现“毛刺”——比如消息延迟、偶发卡顿、帧乱序或短暂中断，并非网络抖动导致，而是代理层缓冲与协议特性冲突的典型表现。核心问题在于：Nginx默认按HTTP短连接逻辑缓存/分块响应，而WebSocket是持续流式二进制帧传输，中间任何缓冲、重写或分段都会破坏帧边界和时序。
关闭Nginx代理缓冲与响应体处理
Nginx若启用proxy_buffering on或proxy_buffer_size等参数，会将WebSocket帧攒够一定大小再转发，造成毫秒级延迟毛刺；更严重的是proxy_http_version 1.0或未禁用gzip时，可能对WebSocket帧做错误压缩或分块。
- 在location或upstream配置中显式关闭缓冲：
proxy_buffering off;proxy_buffer_size 4k;（仅设最小值，不启用多级缓冲） - 禁用所有可能干预响应体的模块：
gzip off;proxy_redirect off;proxy_set_header X-Accel-Buffering "no";（兼容部分Nginx版本） - 确保
proxy_http_version 1.1已启用（必须项，非可选项）
禁用Nginx日志记录与请求体读取
WebSocket连接建立后，后续ping/pong、文本/二进制帧均不带HTTP语义，但Nginx若开启log_format中含$request_body，或配置了client_max_body_size、client_body_timeout，会尝试读取并解析无意义的帧数据，引发内核等待与CPU毛刺。
生成Blender Python (bpy)脚本，该脚本使用node_groups API和GeometryNodeTree接口程序化地创建几何节点修改器树，用于参数化3D资产生成。
- 为WebSocket路径单独配置日志格式，移除
$request_body、$http_*等易触发解析的变量 - 在对应location中添加：
client_max_body_size 0;（禁用请求体限制）client_body_timeout 0;（跳过请求体超时检查） - 避免使用
limit_req或auth_request等需完整解析请求的模块作用于WS路径
调整TCP栈与内核参数防粘包抖动
即使Nginx配置正确，Linux内核的TCP延迟确认（Delayed ACK）、Nagle算法仍可能合并小帧或引入200ms级延迟，表现为“偶尔卡一下”。Node.js服务端若未显式禁用Nagle，也会加剧该问题。
- Node.js服务端创建连接时禁用Nagle：
ws.on('connection', (socket) => { socket.setNoDelay(true); }); - Nginx所在服务器调优（临时生效）：
sysctl -w net.ipv4.tcp_delayed_ack=0sysctl -w net.ipv4.tcp_nodelay=1 - 若使用TLS（wss），确保OpenSSL版本≥1.1.1，且Nginx启用
ssl_buffer_size 4k;避免TLS层分片放大延迟
验证是否仍有隐式代理干扰
某些CDN或云WAF（如Cloudflare、阿里云DDoS防护）会在Nginx上游自动注入缓冲或改写Connection头，导致Nginx收不到原始Upgrade信号，或收到被篡改的Sec-WebSocket-Key。
- 用curl直连Nginx后端（绕过CDN）测试：
curl -i -N -H "Upgrade: websocket" -H "Connection: Upgrade" http://localhost:3000/ws - 对比抓包（tcpdump）：分别捕获客户端→CDN、CDN→Nginx、Nginx→Node三个环节，确认Upgrade头全程透传、无新增/删减字段
- 若CDN不可控，可在Nginx入口处强制重写关键头：
proxy_set_header Upgrade $http_upgrade;proxy_set_header Connection "upgrade";
并添加proxy_hide_header X-Content-Type-Options;等防止WAF注入干扰头
