You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

使用PyInstaller打包py_mini_racer项目为exe时缺少mini_racer.dll报错如何解决?

报错触发原因

py_mini_racer 库依赖原生动态链接库 mini_racer.dll 实现JS解析功能,PyInstaller默认打包逻辑仅会自动识别Python代码文件,不会主动收录第三方库附带的二进制dll文件,因此打包后的程序运行时无法在指定路径找到该文件,触发该RuntimeError。

解决方案
  • 第一步:先定位本地Python环境中mini_racer.dll的存放路径,默认路径为你的Python安装目录/Lib/site-packages/py_mini_racer/mini_racer.dll,如果使用虚拟环境则路径为虚拟环境根目录/Lib/site-packages/py_mini_racer/mini_racer.dll。
  • 第二步:通过PyInstaller命令参数指定打包该dll,执行打包命令时添加--add-binary参数即可,完整命令示例:
pyinstaller --onefile --add-binary "你本地的mini_racer.dll完整路径;./py_mini_racer/" 你的项目主程序.py

注:Windows系统使用分号;分隔源路径和目标路径,Linux/macOS系统替换为冒号:。

  • 如果你使用spec文件配置打包规则,直接修改spec文件中的datas配置项,添加如下条目后重新用spec文件打包即可:
datas = [
    ("你本地的mini_racer.dll完整路径", "./py_mini_racer/"),
    # 其余原有配置保留
]
  • 若你使用非单文件打包模式(不加--onefile参数),也可以在打包完成后,手动在生成的dist目录下新建py_mini_racer文件夹,将mini_racer.dll放入该文件夹即可正常运行。
注意事项

打包前可以先升级对应工具到最新版本,避免版本兼容导致的识别失效问题,升级命令:
pip install -U pyinstaller py_mini_racer

内容的提问来源于stack exchange,提问作者Mobeen Ghaffar

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.06 12:54:00