Flask SocketIO切换至gevent后无法从服务器向客户端发送事件

我的Flask SocketIO服务器使用默认开发服务器时可正常发送事件，但切换至gevent后，无法从服务器向客户端发送事件。

原测试代码 #

import flask      
from __main__ import app, socketio

@app.route("/my-func", methods=["POST"])
def start_func():
    socketio.emit("start func")  # 完全未触发，直接跳过

尝试过的修改代码（仍无效） #

import flask      
from __main__ import app, socketio

def emit_start_func():
    socketio.emit("start func")

@app.route("/my-func", methods=["POST"])
def start_func():
    socketio.start_background_task(emit_start_func)  # 还是无法触发

服务器配置代码 #

from gevent import monkey; monkey.patch_all()
import flask                                      
from flask_socketio import SocketIO
from gevent.pywsgi import WSGIServer

app = flask.Flask(__name__)
socketio = SocketIO(app, async_mode="gevent")
app.secret_key = "secret"

if __name__ == "__main__":
    host = "localhost"
    port = 8888
    print(f"* Running on http://{host}:{port}")
    WSGIServer((host, port), app).serve_forever()

问题排查与解决方法 #

1. 核心问题：错误的服务器启动方式
   你直接用WSGIServer包装Flask app启动，但Flask-SocketIO需要通过自身的socketio.run()方法启动，才能确保SocketIO的事件系统与gevent服务器正确绑定。直接使用WSGIServer会跳过SocketIO的初始化逻辑，导致事件无法正常推送。

2. 修正启动代码
   将服务器启动部分替换为：

   if __name__ == "__main__":
       host = "localhost"
       port = 8888
       print(f"* Running on http://{host}:{port}")
       socketio.run(app, host=host, port=port)
   

   socketio.run()会自动处理gevent服务器的启动，同时完成SocketIO的路由和事件循环配置。

3. 依赖完整性检查
   确保安装了全部必要依赖：

   pip install flask-socketio gevent gevent-websocket
   

   缺少gevent-websocket会导致WebSocket连接异常，间接影响事件推送功能。

4. 背景任务的注意事项
   如果需要在视图函数中用后台任务发送事件，socketio.start_background_task的用法是正确的，但前提是服务器启动方式正确。修正启动方式后，无论是直接在视图中emit还是通过后台任务emit，都能正常工作。

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