前端 new WebSoCket 时带上子协议 chat.v2,握手直接 400。浏览器控制台只有一句 Error during WebSocket handshake,看不到具体原因。
用 curl 手工发握手请求,服务端返回 400,响应体是空的。把子协议参数去掉,能正常升级到 101。也就是说问题出在这个参数上。
第一反应是 Nginx 拦了,把 Sec-WebSocket-Protocol 加进 proxy_set_header 再转发,还是 400。这个头默认就会透传,卡点不在代理。
后端是 Spring 的 WebSocketHandler,注册时只写了 addHandler,没有重写 getSubProtocols。客户端请求了 chat.v2,服务端不回这个头,浏览器就判协商失败,直接断开。
const ws = new WebSocket('wss://im.example.com/ws', ['chat.v2']);
ws.onopen = () => console.log('protocol', ws.protocol);
ws.onerror = () => console.log('handshake failed');
服务端选中的子协议必须出现在客户端的候选列表里,而且只能回一个。回多个,或者回一个客户端没提过的值,浏览器同样判失败,而且不给任何提示。
public List<String> getSubProtocols() {
return Collections.singletonList("chat.v2");
}
改完能 101,但压测时又冒偶发 400。抓包看到部分请求带的是 chat.v2,chat.v1,逗号后面有空格,代码里切完没 trim,匹配不上。加一步 strip 解决。
确认:curl 带 Upgrade 和 Sec-WebSocket-Protocol 两个头,看到 101 且响应里有 Sec-WebSocket-Protocol: chat.v2;再用浏览器跑一遍,ws.protocol 打出 chat.v2 才算过。
