Flask SocketIO异步运行故障：调用内部异步函数无响应如何解决？

核心问题分析 #

你的代码里直接在同步的SocketIO事件函数中使用await，会导致异步函数无法被正确调度，所以调用无反应。需要调整SocketIO的初始化配置、事件函数定义方式来适配异步逻辑。

具体解决方案 #

1. 初始化异步兼容的SocketIO实例
   初始化时指定async_mode='asyncio'，强制启用异步IO模式：

   from flask import Flask
   from flask_socketio import SocketIO
   
   app = Flask(__name__)
   socketio = SocketIO(app, async_mode='asyncio')
   

2. 将SocketIO事件处理函数改为异步函数
   把同步的def message()改为async def message()，这样才能在函数内部合法使用await调用异步函数：

   @socketio.event
   async def message():
       # 保留你的原有业务逻辑（同步逻辑可直接复用，无需修改）
       # ... 你的代码片段 ...
       await onUploadData()  # 现在可正常触发异步函数执行
   

3. 确保onUploadData是标准异步函数
   确认目标函数本身用async def定义，内部包含合法的异步操作（比如异步IO、asyncio.sleep等）：

   import asyncio
   
   async def onUploadData():
       # 示例异步操作，替换为你的实际业务逻辑
       await asyncio.sleep(1)
       print("异步数据上传逻辑执行完成")
       # 可添加异步数据库操作、异步API调用等逻辑
   

4. 用SocketIO专属方法启动服务
   不要使用Flask原生的app.run()，改用socketio.run()启动，确保异步模式生效：

   if __name__ == '__main__':
       socketio.run(app, debug=True, host='0.0.0.0', port=5000)
   

额外适配场景（可选） #

如果使用外部ASGI服务器（如uvicorn），需将async_mode改为'asgi'，并以ASGI模式启动：

socketio = SocketIO(app, async_mode='asgi')

if __name__ == '__main__':
    import uvicorn
    uvicorn.run(app, host='0.0.0.0', port=5000)

内容的提问来源于stack exchange，提问作者Степан Захаров