PyInstaller打包SQLAlchemy+pytds脚本报错：无法加载mssql.pytds插件

算力阿峰

2026-7-18

解决PyInstaller打包SQLAlchemy+mssql.pytds的模块缺失问题

以下是几种可行的解决方法：

直接在打包命令中添加隐藏导入
使用--hidden-import参数告诉PyInstaller主动包含缺失的方言模块，执行命令：
```
pyinstaller --onefile --hidden-import sqlalchemy.dialects.mssql.pytds main.py
```
通过spec文件配置隐藏导入
1. 先生成spec配置文件：
```
pyinstaller --onefile main.py
```
2. 打开生成的main.spec文件，找到Analysis部分的hiddenimports列表，添加缺失的模块：
```
a = Analysis(
    ['main.py'],
    # ... 其他参数
    hiddenimports=['sqlalchemy.dialects.mssql.pytds'],
    # ... 其他参数
)
```
3. 用spec文件重新打包：
```
pyinstaller main.spec
```
在代码中显式导入模块
在你的main.py开头添加一行显式导入，让PyInstaller在扫描代码时自动识别并包含该模块：
```
import sqlalchemy.dialects.mssql.pytds
```
之后再正常执行打包命令即可。