为什么 WebSocket 无法通过 Nginx 连接？

Question

IT Interview Practice · Accepted Answer

首先区分握手失败与连接打开后又关闭。两种症状需要不同的检查方向。

## 让应用收到升级请求

对于专用 WebSocket 路由，在 `server` 内加入：

```nginx
location /socket/ {
    proxy_pass http://127.0.0.1:3000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
}
```

`proxy_http_version` 明确指定向后端使用 HTTP/1.1。`Upgrade` 转发客户端请求的协议切换。`Connection` 告诉后端该连接正在请求切换。需要明确转发这些头，因为代理不会直接把每个与连接相关的头都传递下去。

## 解读结果

握手成功返回 `101 Switching Protocols`。如果收到 404，检查后端路径；如果认证失败，检查应用策略。代理配置不能替代认证和允许来源检查。

如果连接打开后因不活跃而关闭，检查 Nginx 及其他代理的空闲超时。结合服务端发送的 WebSocket ping 帧、合适的 `proxy_read_timeout` 和客户端重连机制。只增加超时可能让失效连接保留更久。

[官方文档](https://nginx.org/en/docs/http/websocket.html).

让应用收到升级请求

解读结果

相关问题