nginx 处理 websocket 客户端异常断开的核心做法是配置 proxy_read_timeout 和 proxy_send_timeout，并配合 keepalive 指令管理上游连接。当客户端非正常断开时，nginx 会检测到连接中断，自动清理相关的代理缓冲区和文件描述符，防止资源泄漏。
Nginx 如何识别 WebSocket 连接的异常断开状态？
Nginx 通过 TCP 层面的错误信号来识别异常断开。当客户端直接关闭 socket 而不发送 FIN 包，或者中间网络故障导致连接重置（RST）时，Nginx 的 I/O 多路复用器（如 epoll 或 kqueue）会立即收到可读或可写事件，但随后的读写操作会返回 ECONNRESET 或 EPIPE 错误。此时 Nginx 不会等待超时，而是立即触发清理逻辑。
server {
listen 80;
server_name ws.example.com;
location /ws {
proxy_pass http://backend;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
# 关键配置：处理异常断开
proxy_read_timeout 86400s;
proxy_send_timeout 86400s;
# 保持与后端的长连接
proxy_set_header Host $host;
}
}
在上述配置中，proxy_read_timeout 设置为极长时间（如 86400s），主要是为了防止在空闲状态下 Nginx 主动切断连接。但对于“异常断开”，即客户端突然消失的情况，Nginx 并不依赖这些超时值来判断，而是依赖底层的 TCP 错误。如果后端服务需要感知这种断开，它会在尝试写入数据时收到 EPIPE 错误，从而知道客户端已离线。
如何确保 Nginx 在断开后正确释放资源？
为了确保资源正确释放，必须启用 proxy_next_upstream 的适当行为，并合理设置 keepalive 连接池。当检测到客户端断开时，Nginx 会标记当前的代理连接为不可用，并从连接池中移除该连接。如果配置了多个后端节点，Nginx 可能会尝试切换到下一个节点（如果业务允许重试），否则直接返回错误给客户端或关闭连接。
# upstream backend {
# server 127.0.0.1:8080;
# keepalive 32;
# }
server {
listen 80;
server_name ws.example.com;
location /ws {
proxy_pass http://backend;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
# 优化资源释放
proxy_buffering off;
proxy_request_buffering off;
# 当后端断开或错误时，不立即重试，避免无效请求
proxy_next_upstream error timeout invalid_header http_500 http_502 http_503 http_504;
proxy_next_upstream_timeout 0;
proxy_next_upstream_tries 0;
}
}
这里的关键在于 proxy_buffering off 和 proxy_request_buffering off。默认情况下，Nginx 会缓冲来自后端的响应。如果客户端断开，Nginx 仍然会尝试将缓冲区中的数据发送给客户端，直到发现连接断开。关闭缓冲可以显著减少内存占用和 CPU 开销，因为数据流式传输，一旦客户端断开，Nginx 立即停止从后端读取数据。同时，proxy_next_upstream_tries 0 确保在 WebSocket 这种长连接场景下，不会因为单次错误而无限重试，从而快速释放资源。
基于 proxy_read_timeout 参数对空闲连接的具体影响是什么？
当 proxy_read_timeout 设置为一个较小的值（例如 60s）时，如果 WebSocket 连接在 60 秒内没有任何数据交换，Nginx 会主动关闭与后端的连接。这虽然能防止僵尸连接，但对于真正的 WebSocket 应用来说，可能会导致心跳检测失败或被误判为断开。因此，对于 WebSocket，通常建议将此值设得非常大，或者依靠应用层的心跳机制来维持连接活性，而让 Nginx 专注于处理突发性的异常断开事件。
