我之前踩过PyInstaller打包Flask-SocketIO+gevent的类似坑，结合你的描述，咱们一步步拆解问题根源和解决方向：

核心问题分析 #

直接跑Python脚本正常，但打包成EXE就报错，本质是PyInstaller的冻结环境和原生Python环境的依赖加载逻辑差异：

• 原生Python环境下，gevent的猴子补丁、依赖模块的查找都是动态且完整的；
• 但打包后，PyInstaller只会把显式/隐式导入的模块打包进去，一旦有遗漏（哪怕是库内部的隐式依赖），就会导致驱动找不到，触发Invalid async_mode错误。

你当前的配置里有些冗余的hiddenimports反而可能干扰检测，同时缺少gevent打包必需的运行时钩子。

具体解决步骤 #

1. 精简并修正hiddenimports配置 #

把你.spec文件里的hiddenimports精简到只保留gevent和SocketIO/EngineIO核心依赖，去掉asyncio、aiohttp等无关驱动（你已经明确用gevent，这些只会引发不必要的警告）：

hiddenimports = [
    'gevent',
    'gevent.monkey',
    'gevent.socket',
    'gevent.threading',
    'gevent._semaphore',
    'geventwebsocket',
    'greenlet',
    'engineio.async_drivers.gevent',
    'flask_socketio',
    'engineio'
]

说明：之前你加的gevent._socket3可能是版本差异导致的，换成通用的gevent.socket更稳妥；另外删掉asyncio相关的导入，避免PyInstaller去查找不存在的驱动模块。

2. 添加gevent专属的PyInstaller运行时钩子 #

PyInstaller自带针对gevent的运行时钩子，用来处理冻结环境下的协程初始化和猴子补丁逻辑，必须在spec文件里指定：

# 在你的.spec文件里添加这一行
runtime_hooks = ['pyi_rth_gevent.py']

这个钩子是PyInstaller内置的，不需要你自己写，它会确保gevent在EXE启动时正确初始化。

3. 强制猴子补丁的执行顺序 #

在你的runapp.py最顶部就执行gevent猴子补丁，确保在导入任何其他模块（包括Flask）之前生效：

# runapp.py 第一行就写这个！
import gevent.monkey
gevent.monkey.patch_all()

# 之后再导入其他模块
from flask import Flask
from your_app_package import app, socketio

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

打包后，模块导入的顺序优先级和原生环境不同，提前打补丁能避免原生socket/threading模块先被加载，导致gevent无法接管。

4. 清理缓存后重新打包 #

在Jenkins里运行PyInstaller时，加上--clean参数清除旧的打包缓存，避免残留的错误依赖干扰：

pyinstaller --clean your_app.spec

5. 排查版本兼容性（可选但关键） #

确认你的依赖版本完全兼容：

• Flask-SocketIO 5.3.6 对应的gevent推荐版本是24.x~25.x（你用的25.8.2没问题）；
• greenlet 3.2.4和gevent 25.8.2是兼容的，但如果还是有问题，可以降级到greenlet 3.0.3试试（部分环境下高版本greenlet会有冻结环境的适配问题）。

调试技巧（如果还是没解决） #

如果执行以上步骤后仍报错，可以在__init__.py里加调试代码，看打包后EngineIO是否能找到gevent驱动：

# 在初始化socketio之前添加
import engineio.async_drivers
print("当前可用的异步驱动：", dir(engineio.async_drivers))
print("gevent驱动是否存在？", hasattr(engineio.async_drivers, 'gevent'))

# 然后再初始化socketio
socketio = SocketIO(app, cors_allowed_origins="*", async_mode="gevent")

打包成EXE后运行，看控制台输出，如果gevent驱动不存在，说明还是有依赖没被打包进去，再针对性补充hiddenimports。

为什么直接跑脚本没问题？ #

原生Python环境下，解释器会动态搜索site-packages下的所有模块，哪怕是库内部隐式导入的依赖都能找到；但PyInstaller是静态分析导入关系，只会打包显式或通过hiddenimports指定的模块，一旦库内部有importlib.import_module这类动态导入，就会漏掉，这就是核心差异。