使用auto-py-to-exe生成的Python可执行文件在客户端运行时触发RuntimeError

核心问题分析 #

错误指向pythonnet库的Python.Runtime.Loader.Initialize无法解析，本质是打包过程未正确包含pythonnet的依赖文件，或目标机器缺少webview依赖的.NET Framework环境，同时webview默认的WinForms平台在打包时存在兼容性隐患。

具体解决方案 #

1. 强制WebView使用CEF平台替代WinForms #

WinForms依赖pythonnet和.NET，打包易出问题，切换到CEF（Chromium Embedded Framework）可避开这类依赖：

import webview

# 启动时指定CEF平台
webview.start(gui='cef')

先安装CEF相关依赖：

pip install pywebview[cef]

2. 调整Auto-Py-To-Exe打包配置 #

• 添加额外依赖文件：在"Additional Files"选项中，找到本地Python环境下的Lib\site-packages\pythonnet\runtime文件夹，将整个文件夹添加到打包列表，设置输出路径为pythonnet/runtime/（保持相对路径一致）。
• 补充隐藏导入：在"Advanced"选项的额外命令行参数中，添加--hidden-import=clr和--hidden-import=pythonnet。
• 路径兼容性：取消OneDrive路径运行，让客户端将exe文件夹复制到本地磁盘（如桌面）再启动，避免同步机制导致的文件锁定或路径解析异常。

3. 确保目标机器具备.NET环境 #

即使切换到CEF，部分依赖仍可能需要.NET支持，要求客户端安装微软官方提供的.NET Framework 4.8运行时（体积小，安装便捷）。

4. 直接用PyInstaller命令行打包（替代auto-py-to-exe） #

若图形化工具配置受限，用命令行打包更灵活：

pyinstaller --onefile --windowed --hidden-import=clr --hidden-import=pythonnet --add-data "本地pythonnet/runtime路径;pythonnet/runtime" app.py

将本地pythonnet/runtime路径替换为实际路径，比如C:\Python39\Lib\site-packages\pythonnet\runtime。

验证步骤 #

打包完成后，在未安装Python的干净虚拟机上测试运行，确认无依赖问题后再交付客户端。

内容的提问来源于stack exchange，提问作者João Gabriel