Pyinstaller 打包flask_socketio为exe程序后出现:ValueError: Invalid async_mode specified

Pyinstaller 打包flask_socketio为exe程序后出现:ValueError: Invalid async_mode specified

一、详细描述问题描述

|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Traceback (most recent call last): File "app_3.py", line 22, in <module> File "flask_socketio\init.py", line 186, in init File "flask_socketio\init.py", line 242, in init_app File "socketio\base_server.py", line 34, in init File "engineio\base_server.py", line 94, in init ValueError: Invalid async_mode specified |

二、解决方法

1.确认flask_socketio的版本,如 flask_socketio version>5.x 。则不需要async_mode=''参数。使用 pip show flask_socketio 命令查看版本,版本信息如下。

|-------------------------------------|
| Name: Flask-SocketIO Version: 5.5.1 |

可运行的最小基础代码如下,可在该代码验证环境是否正常,index.html为首页可在template文件夹中自行创建。注意allow_unsafe_werkzeug=True,这个配置必须添加。否则会出现错误。

|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| app = Flask(name) app.secret_key = 'your_secret_key' # socketio = SocketIO(app, async_mode='eventlet') # 5.x版本已废弃该命令 socketio = SocketIO(app) @app.route('/') def welcome(): return render_template('index.html') if name == 'main': socketio.run(app, host='0.0.0.0', port=5000, debug=True, allow_unsafe_werkzeug=True) |

index.html文件如下:

|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>Welcome</title> <link rel="stylesheet" href="{{ url_for('static', filename='style.css') }}"> </head> <body> <h1>Welcome to My Flask App!</h1> <p>This is a simple welcome page.</p> </body> </html> |

  1. 使用pyinstaller命令打包,这一步打包后会生成一个配置参数文件app.spec。注意确保

确保根目录下有templates, static两个文件夹。

|------------------------------------------------------------------------------------------------------|
| pyinstaller --onefile --noconsole --add-data="templates;templates" --add-data="static;static" app.py |

  1. 打包完成后,找到app.spec配置文件。完成如下操作:

(1)在相关的行,强制添加如下库的依赖。信息如下。

|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| a = Analysis( 'app.py', pathex=\[\], binaries=\[\], hiddenimports="gevent","geventwebsocket","gevent.ssl","gevent.builtins","engineio.async_drivers.threading", datas=('templates', 'templates'), ('static', 'static'), hookspath=\[\], hooksconfig={}, runtime_hooks=\[\], excludes=\[\], noarchive=False, optimize=0, ) |

(2)修改配置,开启后台运行窗口模型

|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| exe = EXE( pyz, a.scripts, a.binaries, a.datas, \[\], name='app', debug=False, bootloader_ignore_signals=False, strip=False, upx=True, upx_exclude=\[\], runtime_tmpdir=None, console=True, # False -> True disable_windowed_traceback=False, argv_emulation=False, target_arch=None, codesign_identity=None, entitlements_file=None, ) |

(3)删除原来的dist、bulid文件文件,使用 pyinstaller app.spec命令重新打包。

|----------------------|
| pyinstaller app.spec |

  1. 打包完成后,找到app.exe文件,点击后。exe程序将以黑窗口模式后台运行。
相关推荐
sanjiaomao33328 分钟前
从论文公式到Python实现:用单元测试校验滑动平均算法
python·算法·单元测试
linweidong2 小时前
中科闻歌Java面试题及参考答案
java·python·大模型·提示词·ai agent·mcp·rag原理
小玮看世界3 小时前
[Python]OD算法在OD实际运用转化参考清单
开发语言·python·算法
萧鼎3 小时前
2026实战:用 tomlkit 优雅读写 TOML 配置,告别手写解析器
python·开源·教程·python库
小刘在重生~3 小时前
Java 常用类|包装类 装箱拆箱、Integer 缓存面试题
java·python·缓存
2601_962099464 小时前
Python xlwt设置excel单元格字体及格式
python·excel·xlwt·样式设置·单元格格式
奇牙coding1234 小时前
GPT-6-Astra API 接入教程:OpenRouter 路由配置 + Python/curl 示例 + 静默降级踩坑
开发语言·python·gpt·ai
2601_962298274 小时前
Python与Selenium结合的Web自动化测试全流程实践教程
自动化测试·python·selenium·web测试·pageobjectmodel
天衍四九-5 小时前
第一章:从 LLM 到 Agent —— DeepSeek Harness 入门
网络·数据库·人工智能·python
529宝宝起名网5 小时前
用 Python 实现名字寓意评分算法:基于 NLP 语义分析的名字内涵深度评估
python·算法·自然语言处理