PyInstaller编译Python GUI项目生成的.exe无法运行，报longjump错误

• 基于Python 3开发的GUI项目，用PyInstaller打包生成.exe后，运行时控制台短暂弹出显示"longjump"随即关闭，程序无法正常启动
• 打包命令：path_to_master_file.py -i path_to_icon --collect-submodules imports
• 项目依赖：numpy、multiprocessing、tkinter、colorsys、math、primer3、Bio.SeqUtils，以及同目录下多个自定义.py文件（总代码量超1500行）
• 已确认信息：tkinter无问题（简单GUI项目可正常打包运行）；主文件已在所有导入完成后第一行添加multiprocessing.freeze_support()；代码在Python解释器中运行完全正常
• 已尝试的无效方案：使用--onefile选项打包、排查multiprocessing相关代码、以管理员身份运行/编译、替换--collect-submodules imports为-d imports确认依赖导入

1. 捕获完整错误日志 #

打开CMD，切换到exe所在目录，执行以下命令：

your_app.exe > error.log 2>&1

该命令会把所有运行时输出（包括隐藏的错误栈）写入error.log文件，通过日志定位具体报错点——仅"longjump"提示不足以排查问题。

如果日志指向multiprocessing相关错误：

• 确保子进程的执行代码完全包裹在if __name__ == '__main__':块内，即使已经添加了multiprocessing.freeze_support()
• 用--hidden-import显式指定primer3、Bio.SeqUtils的子模块，比如：

  pyinstaller path_to_master_file.py -i path_to_icon --hidden-import primer3 --hidden-import Bio.SeqUtils
  

2. 优化PyInstaller打包参数 #

• 替换模糊的--collect-submodules imports，改为针对特定库收集子模块，比如--collect-submodules Bio --collect-submodules primer3，避免过度收集或遗漏关键依赖
• 添加--debug all参数重新打包，运行时会输出详细的模块加载日志，能直接看到哪个模块/资源加载失败
• 若使用了同目录下的自定义库，要么在打包命令中显式指定这些文件，要么生成.spec文件（执行pyi-makespec path_to_master_file.py），在hiddenimports列表中添加自定义模块名

3. 排查第三方库兼容性 #

primer3和Bio.SeqUtils这类生物信息学库常存在PyInstaller打包兼容问题：

• 检查这些库是否有依赖的动态链接库（.dll），PyInstaller可能未自动收集，需要手动在.spec文件的datas或binaries项中添加
• 尝试降级或升级库版本，比如使用BioPython的稳定版（如1.79），避免最新版本的兼容性bug
• 对numpy添加--collect-data numpy参数，确保其数据文件被完整收集

4. 其他排查点 #

• 检查exe目录是否缺失资源文件（如图标、配置文件），PyInstaller不会自动收集非代码资源，需在.spec文件的datas中指定路径
• 临时关闭杀毒软件/防火墙，部分安全软件会拦截PyInstaller打包的exe，导致运行异常
• 在另一台Windows设备上测试exe，排除本地系统环境（如权限、库冲突）的问题

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