You need to enable JavaScript to run this app. Python Flask SocketIO服务运行卡住无响应该如何解决?
优惠活动
大模型
产品
解决方案
定价
更多

Python Flask SocketIO服务运行卡住无响应该如何解决?

解决Flask-SocketIO启动卡住无输出的方案

你遇到的问题通常是异步运行环境配置不正确导致的,按以下步骤调整即可解决:

  • 第一步:添加eventlet猴子补丁
    仅安装eventlet不够,必须在代码最开头执行猴子补丁替换标准库的IO接口,否则会出现阻塞无输出的情况
  • 第二步:显式指定异步模式
    Flask-SocketIO默认自动检测异步模式,检测逻辑异常时会导致卡住,初始化时显式指定async_mode参数即可
  • 第三步:配置启动参数
    显式指定监听地址、端口,关闭调试模式的自动重载器(避免多进程冲突导致卡住)
  • 第四步:端口占用排查
    如果修改后仍无响应,可尝试更换启动端口,避免5000端口被系统其他服务(如macOS的AirPlay服务)占用

修改后的可正常运行代码如下:

# 必须放在所有导入最前面
import eventlet
eventlet.monkey_patch()

from flask import Flask, render_template
from flask_socketio import SocketIO

app = Flask(__name__, static_folder="statics", template_folder="templates")
# 显式指定异步模式为eventlet
socketio = SocketIO(app, async_mode='eventlet')


@app.route("/")
def main():
    return render_template('index.html')


@socketio.event
def connect(sid, environ):
    print(sid, 'connected')


@socketio.event
def disconnect(sid):
    print(sid, 'disconnected')


if __name__ == "__main__":
    # 显式指定监听地址、端口,关闭自动重载
    socketio.run(app, host='0.0.0.0', port=5000, debug=True, use_reloader=False)

如果是Windows系统下eventlet存在兼容性问题,可将异步模式替换为async_mode='threading'临时测试,生产环境建议使用WSL或者Linux环境运行eventlet版本。

内容的提问来源于stack exchange,提问作者Paul Brink

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.21 07:15:03