Flask-SocketIO应用持续使用Polling而非WebSocket问题求助

我之前也碰到过一模一样的问题！Flask-SocketIO在Nginx后面死活不肯切换到WebSocket，一直赖着用polling，折腾了好一阵才搞定，给你分享几个排查和解决的关键点：

1. Nginx配置缺失WebSocket支持 #

这是最常见的坑——Nginx默认不会自动处理WebSocket的升级请求，得在反向代理配置里手动加规则。

你需要修改Nginx的server配置块，给/socket.io/路径加上这些配置：

location /socket.io/ {
    proxy_pass http://你的Flask应用地址;  # 比如http://127.0.0.1:5000
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    
    # 可选：解决长连接超时问题，把超时时间调长
    proxy_connect_timeout 7d;
    proxy_send_timeout 7d;
    proxy_read_timeout 7d;
}

划重点：proxy_http_version 1.1是必须的，WebSocket依赖HTTP/1.1的Upgrade机制；Upgrade和Connection头是告诉Nginx“这是WebSocket升级请求，别当普通HTTP转发”。

2. Flask-SocketIO的初始化配置要到位 #

确保你的Flask-SocketIO开启了WebSocket支持，并且选对了异步引擎：

from flask import Flask
from flask_socketio import SocketIO

app = Flask(__name__)
# 优先用eventlet（天生支持WebSocket），也可以用gevent（但要额外装gevent-websocket）
socketio = SocketIO(app, cors_allowed_origins="*", async_mode='eventlet')

如果选gevent的话，必须装gevent-websocket包，不然gevent默认不支持WebSocket：

pip install gevent-websocket

3. 前端客户端别强制用Polling #

检查你的前端连接代码，有没有不小心把transport固定成polling了？正确的写法应该是优先尝试WebSocket：

const socket = io({
    query: { token: '1234567890qwertyuiop' },
    transports: ['websocket', 'polling']  // 先试WebSocket，失败再降级到polling
});

要是你只写了['polling']，那客户端肯定不会主动尝试WebSocket连接。

4. AWS环境的额外限制要注意 #

如果你用了AWS的负载均衡，得额外配置：

• Application Load Balancer（ALB）：确保监听规则支持HTTP/1.1，目标组的健康检查配置正常，并且可以把ALB的超时时间调长（比如300秒），避免WebSocket连接被提前断开。
• Classic Load Balancer：建议改用TCP监听模式，因为Classic LB对WebSocket的HTTP支持不够友好，TCP模式可以直接转发WebSocket流量。
  另外，AWS安全组要开放Nginx的端口（80/443）和Flask应用的端口（比如5000）。

5. 开详细日志定位问题 #

可以给Flask-SocketIO开详细日志，看看WebSocket握手失败的具体原因：

socketio = SocketIO(app, cors_allowed_origins="*", logger=True, engineio_logger=True)

这样会输出连接过程的细节，比如是不是跨域问题、握手请求被拦截了之类的，帮你快速定位。

最后记得修改配置后重启Nginx和Flask应用，清除浏览器缓存再测试——有时候浏览器会缓存之前的连接方式，导致新配置不生效。

内容的提问来源于stack exchange，提问作者Lee Melbourne