### PyQt5 应用打包后无法连接 MySQL 数据库的原因分析 在 Windows 10 环境下开发并使用 PyInstaller 将 PyQt5 应用程序打包为可执行文件时，可能会遇到无法连接到 MySQL 数据库的情况。这通常是因为打包过程中某些必要的依赖项未被正确包含。 以下是可能的解决方案： #### 1. **确认支持的驱动** PyQt5 默认仅提供部分数据库驱动的支持列表，例如 SQLite 和 ODBC 驱动[^3]。如果应用程序需要通过 Qt 提供的 QSqlDatabase 接口访问 MySQL，则需确保安装了相应的 MySQL 插件以及配置环境变量。 ```python import os from PyQt5.QtSql import QSqlDatabase, QSqlQuery db = QSqlDatabase.addDatabase('QMYSQL') # 使用 QMYSQL 驱动 if not db.isValid(): raise Exception("MySQL driver is unavailable.") ``` 上述代码片段用于验证 `QMYSQL` 是否可用。如果不可用，请检查是否已安装对应的 MySQL 插件。 --- #### 2. **手动添加插件目录** 当使用 PyInstaller 打包时，默认情况下不会自动包含 Qt 的插件目录（如 `sqldrivers`）。因此，在运行 `.exe` 文件之前，应将这些插件显式复制至目标路径下的子目录中。 具体操作如下： - 查找 Python 安装路径中的 `sqldrivers` 目录位置； - 复制该目录及其内容到最终生成的应用根目录内。 示例命令行脚本可以实现自动化处理过程： ```bash copy "%PYTHON_PATH%\Lib\site-packages\PyQt5\plugins" . ``` 其中 `%PYTHON_PATH%` 替换为你实际使用的 Python 路径。 --- #### 3. **调整 spec 文件设置** 为了更精确控制哪些资源会被嵌入到单个 EXE 文件里，建议编辑由 PyInstaller 自动生成的 SPEC 文件，并加入额外的数据声明语句来指定所需组件的位置。 修改后的部分内容可能看起来像这样: ```spec a = Analysis(['main.py'], pathex=['C:\\path\\to\\your_project'], binaries=[], datas=[('C:/Python/Lib/site-packages/PyQt5/plugins/sqldrivers/*', 'sqldrivers')], hiddenimports=[], hookspath=[], runtime_hooks=[], excludes=[]) ``` 重新构建项目以反映更改效果。 --- #### 4. **测试与调试方法** 完成以上步骤之后仍存在问题的话，可以通过打印日志消息进一步定位错误原因。比如尝试捕获异常信息以便更好地理解哪里出了差错。 ```python try: conn = pymysql.connect(host='localhost', user='root', password='password', database='test_db') except Exception as e: print(f'Error connecting to DB: {e}') finally: pass ``` 此段代码展示了如何利用标准库模块 `pymysql` 来代替原生 Qt SQL 功能作为备选方案之一。 --- ### 总结 综上所述，解决 PyQt5 应用打包后无法正常连接 MySQL 数据库的关键在于补充缺失的动态链接库及相关配置参数。同时注意版本兼容性和操作系统差异带来的影响因素。