部署到服务器后Flask SocketIO频繁返回400状态码问题求助

下面是对应问题的具体排查和解决步骤：

1. 多worker部署未配置会话粘性 #

Flask SocketIO的握手请求需要落到同一个worker处理，如果使用多worker启动服务，未配置会话粘性会导致握手过程中断，返回400，严重时会打乱内部连接状态导致服务宕机。
解决方法：

• 单worker部署直接使用如下启动命令即可，无需额外配置Nginx粘性：

  # 以eventlet为例
  gunicorn --worker-class eventlet -w 1 你的启动模块:app -b 0.0.0.0:8000
  

• 多worker部署需要在Nginx的server块顶层增加会话粘性配置：

  ip_hash;
  

  高版本Nginx也可以使用更精准的sticky cookie配置：

  upstream socketio_server {
      server xxx:8000;
      sticky srv_id expires=1h domain=.你的域名.com path=/;
  }
  # 对应location块的proxy_pass改为 http://socketio_server/socket.io;
  

2. 异步模型不匹配 #

代码中async_mode设为None会自动适配本地环境，但生产环境的异步服务器如果和本地不一致，会导致模型不匹配触发握手失败。
解决方法：
显式指定和生产环境匹配的异步模式，比如用eventlet的话修改初始化代码：

async_mode = "eventlet"
notify_socketio = SocketIO(app, cors_allowed_origins="*", 
                                message_queue=redis_add, 
                                async_mode=async_mode
                            )

3. 前后端Socket.IO版本不兼容 #

你后端使用的python-socketio==5.4.0仅兼容3.x版本的Socket.IO前端JS，如果前端引入的是2.x版本的JS包，会出现频繁400握手失败的问题。
解决方法：
将前端Socket.IO JS替换为3.x版本即可。

4. Nginx超时配置问题 #

当前仅在根location配置了300s超时，Socket.IO长连接需要更长的超时时间，否则会被Nginx主动断开导致频繁重连触发400。
解决方法：
在/socket.io的location块增加超时配置：

proxy_read_timeout 86400s;
proxy_send_timeout 86400s;

5. Redis连通性异常 #

代码中写死的Redis地址是localhost:6379，需要确认服务器上Redis服务正常运行，端口可访问，Redis连接失败会导致SocketIO内部逻辑报错，触发400甚至服务崩溃。
排查方法：
在服务器执行redis-cli ping，确认返回PONG即正常。

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