PyInstaller打包含C编译MT5Manager的Python程序报错求助

问题描述 #

本地运行python main.py正常，但PyInstaller生成的exe文件执行时，初始化MT5Manager.ManagerAPI()抛出以下错误：

Traceback (most recent call last):
  File "main.py", line 5, in <module>
    manager = MT5Manager.ManagerAPI()
              ^^^^^^^^^^^^^^^^^^^^^^^
SystemError: <class 'MT5Manager.ManagerAPI'> returned NULL without setting an exception
[6680] Failed to execute script 'main' due to unhandled exception!

核心原因 #

MT5Manager是C语言编译的Python扩展包，依赖特定的动态链接库（.dll）。PyInstaller默认不会自动识别并打包这些非Python的二进制依赖，导致exe运行时无法找到必要的dll文件，进而初始化失败。

解决步骤 #

方法1：手动复制依赖DLL #

• 打开虚拟环境中MT5Manager的安装目录：.venv\Lib\site-packages\MT5Manager
• 将目录下所有.dll文件复制到PyInstaller生成的exe所在的dist文件夹（与exe文件同级）
• 重新运行exe文件

方法2：通过PyInstaller参数自动打包DLL #

修改打包命令，使用--add-binary参数指定需要打包的MT5Manager依赖文件：

pyinstaller -F main.py --paths .venv\Lib\site-packages --add-binary ".venv\Lib\site-packages\MT5Manager\*.dll;."

• *.dll;.表示将匹配到的所有dll文件打包后放置在exe的根目录

方法3：验证Python版本兼容性 #

部分C扩展包对最新Python版本支持滞后，MT5Manager可能未适配Python 3.12。可以切换到更稳定的版本测试：

1. 使用pyenv-win切换Python版本：

   pyenv install 3.11.9
   pyenv local 3.11.9
   

2. 重新创建虚拟环境、安装依赖并打包

方法4：放弃单文件模式（可选） #

单文件模式下PyInstaller会将所有资源解压到临时目录，可能引发路径识别问题。改用目录模式打包：

pyinstaller main.py --paths .venv\Lib\site-packages --add-binary ".venv\Lib\site-packages\MT5Manager\*.dll;."

运行dist\main\main.exe测试

内容的提问来源于stack exchange，提问作者Nguyễn Đức Huy