Flask 1.1.2+Flask-SocketIO 5.0.1连接WebSocket报400错误
400错误核心触发原因
- 前后端Socket.IO版本不兼容:当前后端Flask-SocketIO 5.0.1依赖的python-socketio 5.0.4采用的是4.x版本的Socket.IO握手协议,而前端引用的是2.2.0版本的socket.io.js,跨两个大版本的协议差异会直接导致握手校验失败,返回400状态码。
- 跨域拦截触发400:Flask-SocketIO 5.x版本默认开启跨域请求拦截,如果前端页面的访问地址与后端服务的域名、端口不一致,没有在初始化时放开跨域权限,WebSocket升级请求会被直接拦截返回400。
- 协程引擎加载错配:依赖列表里同时安装了
eventlet和gevent-websocket两个WebSocket适配层,初始化SocketIO时没有显式指定异步运行模式,框架自动加载的引擎可能与请求处理逻辑不匹配,引发握手错误。 - 事件名逻辑错配(非400直接诱因):后端注册的监听事件为
message,前端连接成功后emit的是my event,事件名称不匹配会导致即使连接成功,数据也无法正常收发。
可直接落地的修复方案
- 对齐前后端Socket.IO版本:将前端引用的socket.io.js替换为与后端python-socketio 5.x兼容的前端4.x版本,保证大版本号完全匹配,不使用跨两个以上大版本的旧版前端脚本。
- 初始化SocketIO时补充跨域放开与异步模式指定,修改后的初始化代码:
socketio = SocketIO( app, async_mode='eventlet', # 显式指定使用eventlet作为协程引擎,也可根据需要替换为gevent cors_allowed_origins="*" # 放开开发环境下的跨域限制 ) - 统一前后端事件命名规则:前端emit的事件名称需要与后端
@socketio.on()装饰器内声明的名称完全一致,示例修正代码:socket.on('connect', function() { // 后端监听的是message事件,这里保持名称匹配 socket.emit('message', 'I\'m connected!'); }); - 启动服务时不要使用
flask run命令,必须通过代码里的socketio.run(app)启动,否则服务跑在默认的Werkzeug同步服务器上,无法正确处理WebSocket协议升级请求,同样会触发400错误。
内容的提问来源于stack exchange,提问作者Lokesh sahu
相关产品推荐
相关产品推荐

