上周给运营后台加实时通知,前端 new WebSocket 一直连不上。Chrome 120 的 Network 面板里那条 ws://idc.00645.com/ws 请求直接返回 403,控制台只丢一句 WebSocket connection to ... failed。第一反应是登录态过期,把同一个 token 拿去请求普通接口,200,鉴权没问题。
翻 nginx 的 access.log,请求确实到了,upstream_status 也是 403,那就是后端拒的握手,不是 nginx 拦的。用 curl 手动模拟,不带 Upgrade 头后端返回 403,自己补上 Upgrade: websocket 和 Connection: Upgrade 再发,状态码变成 101。
location /ws {
proxy_pass http://127.0.0.1:8080;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_read_timeout 300s;
}
差别就在转发这一层。nginx 默认用 HTTP/1.0 回源,也不会自动把 Upgrade 和 Connection 透传,后端收到的请求里这两个头是空的,很多框架的 WebSocket 中间件拿不到升级标记就直接 403。我一开始只加了 proxy_http_version 1.1,Connection 忘了写,照样 403,白折腾半小时。
三个头要一起给。Upgrade 用 $http_upgrade,客户端没发这个头时它是空串,普通请求不会被误升级。Connection 固定写 upgrade 就够用,想严谨一点可以在 http 块里用 map 判断该变量为空时传 close。proxy_read_timeout 顺手调到 300s,默认 60s 比心跳间隔还短的话,连接会被 nginx 掐断,前端报的是 1006,别和 403 混在一起查。
如果站点前面还套了 CDN,这条只改源站没用。Cloudflare 要单独打开 WebSocket 开关,国内一些加速产品默认关着,控制台里找一圈才能看到。
reload 之后 Network 里那条请求变成 101 Switching Protocols,帧正常收发。curl 那两行我留在了部署脚本里,换机器先跑一遍,比从 token 查起快。
