使用cx_Freeze打包含SQLAlchemy的Python脚本为exe时MySQL方言加载失败

我之前也踩过这个一模一样的坑！这是因为cx_Freeze的自动依赖检测机制没法识别SQLAlchemy动态加载的MySQL dialect模块，导致打包后的exe找不到对应的驱动插件。下面是几个亲测有效的解决办法：

方法1：修改setup.py手动指定要包含的模块 #

在你的setup.py脚本里，给build_exe选项添加packages参数，明确把SQLAlchemy的MySQL dialect模块（以及你用的MySQL驱动）包含进去：

from cx_Freeze import setup, Executable

# 定义可执行文件
exe = Executable(
    script="generate_settings.py",
    base=None  # 控制台程序用None，GUI程序可改为"Win32GUI"
)

setup(
    name="generate_settings",
    version="1.0",
    executables=[exe],
    options={
        "build_exe": {
            # 必须包含SQLAlchemy的MySQL dialect
            "packages": ["sqlalchemy.dialects.mysql"],
            # 如果你用pymysql作为MySQL驱动，还要加上它
            # "packages": ["sqlalchemy.dialects.mysql", "pymysql"],
            # 用mysqlclient的话，确保它也被正确包含
        }
    }
)

修改后重新执行python setup.py build打包即可。原理是告诉cx_Freeze：这个模块是必需的，必须打包进去，避免动态导入导致的依赖遗漏。

方法2：在脚本中显式导入MySQL dialect #

如果不想修改setup.py，也可以在你的generate_settings.py脚本开头显式导入MySQL dialect模块，让cx_Freeze的自动检测能捕捉到这个依赖：

# 在脚本最顶部添加这行
from sqlalchemy.dialects import mysql

# 下面是你原来的业务代码
from sqlalchemy import create_engine
# ... 其余代码

这样打包时cx_Freeze会自动把sqlalchemy.dialects.mysql包含进去，无需额外配置setup.py。

方法3：手动复制dialect文件到打包目录 #

如果上面两种方法都没生效，可以试试手动复制文件：

1. 找到你Python环境下的Lib\site-packages\sqlalchemy\dialects\mysql文件夹
2. 把整个mysql文件夹复制到打包后生成的build\exe.win-amd64-3.6\sqlalchemy\dialects\目录下（路径根据你的Python版本和系统调整）
3. 再运行exe文件，应该就能找到对应的插件了

额外注意事项 #

• 确保你的MySQL驱动（比如mysqlclient或pymysql）已经正确安装，并且在打包环境中可以正常使用
• 你的环境版本（Python3.6.1、cx_Freeze5.1.1、SQLAlchemy1.2.1）是兼容的，不存在版本适配问题

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