Flask Socket.io经Gunicorn+Nginx部署后/socket.io请求返回400如何解决

1. 修正Nginx配置中的核心错误 #

你目前的Nginx配置存在两处直接导致400错误的问题：

• 代理目标地址错误：proxy_pass http://127.0.0.1:443/socket.io中的443端口是Nginx自身监听的SSL端口，会导致请求内部循环，无法转发到实际运行的Gunicorn服务。需要替换为Gunicorn实际监听的地址：如果Gunicorn是用端口启动，比如监听本地5000端口，就改为proxy_pass http://127.0.0.1:5000；如果SocketIO和普通HTTP服务共用同一个通过Unix套接字运行的Gunicorn进程，也可以改为proxy_pass http://unix:/run/gunicorn.sock。
• 转义字符错误：proxy_set_header Connection "Upgrade"中的"是HTML转义格式的引号，Nginx无法识别，直接改为proxy_set_header Connection "upgrade";即可。

修正后的socket.io配置块参考：

location /socket.io {
    include proxy_params;
    proxy_http_version 1.1;
    proxy_buffering off;
    proxy_set_header Host $http_host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_cache_bypass $http_upgrade;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    # 替换为你实际Gunicorn监听的地址
    proxy_pass http://127.0.0.1:5000;
}

2. 确认Gunicorn启动参数符合SocketIO要求 #

Flask-SocketIO不支持Gunicorn默认的同步worker，必须使用异步worker才能正常处理WebSocket请求：

• 先安装异步依赖：pip install eventlet 或者 pip install gevent gevent-websocket
• 启动Gunicorn时指定异步worker，示例命令（使用eventlet）：

gunicorn --worker-class eventlet -w 1 你的应用入口文件名:app -b 127.0.0.1:5000

注意：SocketIO服务不要配置多个worker（保持-w 1即可），否则会出现会话丢失、连接异常的问题。

3. 检查Flask-SocketIO跨域配置 #

线上域名和本地测试环境不同，需要明确允许跨域来源，示例代码：

from flask_socketio import SocketIO
# 生产环境建议替换为你的实际域名，测试阶段可临时设置为"*"允许所有来源
socketio = SocketIO(app, cors_allowed_origins="https://你的实际域名")

4. 验证配置生效 #

修改Nginx配置后先执行nginx -t检查语法是否正确，确认无错后执行systemctl reload nginx重载配置，再重启Gunicorn服务即可测试连接。

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