pyinstaller打包exe后不能运行报Failed to execute script XXXX问题分析与处理

最新推荐文章于 2025-09-28 15:33:20 发布
原创 最新推荐文章于 2025-09-28 15:33:20 发布 · 3.1w 阅读 · 41 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#python

博主用Python的tkinter写小工具，用pyinstaller打包成exe后运行出错。通过不带 -w 参数打包，在控制台看到是缺少xlrd模块。找到该模块位置，用 -p 参数打包将其打进去，解决了运行报错问题。总结可通过控制台定位排查打包exe运行问题。
该文章已生成可运行项目，

最近用python的tkinter写了个小工具，发现用pyinstaller打包成exe后运行出错。报Failed to execute script XXXX

pyinstaller -F -w worksubmit.py

报错
为了搞清楚报错的原因，想看到程序具体执行的情况。可以通过不带-w的参数打包在控制台看程序执行情况。
pyinstaller -F worksubmit.py 可以通过不带-w的参数打包，这时打包的exe运行是带控制台的命令行
运行情况
可以清楚的看到

ModuleNotFoundError:No module named ‘xlrd’

这时就要解决打包时xlrd模块没有打进去的问题，找到xlrd模块的位置，并将该模块打到运行程序包里。
先找到程序依赖的xlrd模块的位置，在PyCharm中通过"File"->“Setting”,在项目设置里查看Project interpreter，可以看到xlrd的目录位置。
找包路径

用pyinstall打包的时候通过加-p的参数将依赖的模块打进去。

pyinstaller -F -p
本文章已经生成可运行项目
最低0.47元/天 解锁文章
Python打包exe后报错：Failed to execute script xxxx问题的解决办法
任聪聪的博客
12-25 4万+
本篇文章主要讲解，python 通过 pyinstaller 打包python脚本后输出exe，执行时报错 Failed to execute script【脚本无法执行的错误】解决办法 日期：2021年12月25日 作者：任聪聪 报错现象 报错命令提示：Failed to execute script 问题原因 1.打包缺少模块或文件。 解决办法：通过pyinstaller -F -i 命令进行输出安装包，并获取通过cmd执行查询是否存在bug或者缺少模块的情况，将模块安装完毕，重新执行打包命令即.
【Python】Pyinstaller打包sh文件报错[77353] Failed to execute script ‘GCN-TSA‘ due to unhandled exception解决方案
寸铁的博客
05-13 1689
【Python】Pyinstaller打包sh文件报错[77353] Failed to execute script ‘GCN-TSA‘ due to unhandled exception解决方案
Python打包成exe：PyInstaller全攻略
最新发布
Qinti_mm的博客
09-28 1969
本文介绍了使用PyInstaller将Python程序打包成可执行文件（.exe）的方法，重点内容包括：1）PyInstaller安装及基本打包命令；2）单文件/多文件模式选择；3）控制台/GUI程序打包参数；4）高级选项（图标添加、数据文件处理、模块排除）；5）常见问题解决方案（模块缺失、中文乱码、体积过大）。通过详细的操作步骤和参数说明，帮助开发者实现Python程序的跨平台分发，使程序能在无Python环境的电脑上运行。
failed to execute script 解决方案+命令行执行传参exe
09-19
failed to execute script 解决方案+命令行执行传参exe
亲测有效！python：Failed to execute script ‘pyi_rth_win32comgenpy‘ due to unhandled exception!
abcdefg5_555的博客
01-10 9368
python pyinstaller打包报错：Failed to execute script 'pyi_rth_win32comgenpy' due to unhandled exception! 亲测有效
Failed to execute script ‘first‘ due to unhandled exception:cannot import name问题
wm9028的专栏
05-01 8626
pyinstaller 打成exe,遇到Failed to execute script 'first' due to unhandled exception:cannot import name问题. Failed to execute script 'first' due to unhandled exception:cannot import name 'recordclient' from 'recordtool' (unknown location)
pyinstaller打包报错 Failed to execute script ‘xxx‘ due to unhandled exception:input():lost sys.stdin
派大星球
12-18 3万+
pyinstaller打包报错 Failed to execute script ‘xxx’ due to unhandled exception:input():lost sys.stdin pyinstaller打包exe文件，打开exe报错 Failed to execute script ‘xxx’ due to unhandled exception:input():lost sys.stdin Failed to obtain/convert traceback! 是因为在打包的时候使用了参数
pyinstaller打包exe文件后，运行提示 Failed to execute script xxxx的解决办法
Jxc的个人博客
07-11 5888
前言: 该解决办法仅适用于使用tkinter编写的GUI程序。
Python Qt5封装成exe文件pyinstaller failed to execute script无法运行的问题
leiyanzeng的专栏
05-20 2236
用Qt5做了个带界面的小程序，但是通过pyinstaller封装成exe文件后，程序无法运行，有时候直接报无法运行就退出了，有时候弹出一个提示failed to execute script，退出，在网上查看了很多文章，都没有解决，最后偶然的机会发现了问题的解决方法。 https://blog.youkuaiyun.com/a807296772/article/details/82769835 以上这个链...
Python自动发邮件以及打包报错failed to execute script和DLL load failed while importing win32api: 找不到指定的模块
Gipsyz的博客
07-24 2156
前言 就是新入职老是忘了发每天的日报邮件，然后刚好也不太忙，就想写个自动发邮件的功能来解放一下自己的脑子。 本来想用C#和Unity做这功能的，但因为受到网上这些吹python的人影响。就试了一下。 准备工作 1：安装python。(版本3.8.5) 2：安装PyCharm。(版本2020.1.4) 安装教程链接 没什么好说的，网上都是教程。 需求整理以及执行方案 需求大概就是，定时发送。工作文档作为附件发送。发送和抄送指定人。 原本我想用foxmail的邮件模板来自动修改内容和定时发送。结果只能用pyth
pyhton打包成exe文件，failed to execute script ‘start‘ due to unhandled exception:No module named XXX。
qq_28806579的博客
05-31 3259
之后尝试了”pyinstaller -Fw -i .\pdf.ico --hidden-import=ctypes --hidden-import=psutil --hidden-import=uuid --hidden-import=win32file --hidden-import=pywintypes .\output\main.py”和“pyinstaller -F -c”显示出它的控制台结果都不好使。pip install auto-py-to-exe#安装auto-py-to-exe。
Python 使用pyinstaller打包成exe文件后运行出现Failed to execute script pyi_rth_certifi
05-24
Python 使用pyinstaller打包成exe文件后运行出现Failed to execute script ***的解决方案
Python 打包问题：Failed to execute script app
01-06
网上有很多教程关于怎么用pyinstaller，这里不做介绍，不懂也可以看pyinstaller帮助：pyinstaller –help 问题描述 在精简pyinstaller打包后的exe时，出现 Failed to execute scripte app 问题。无法定位到具体问题。 使用命令 出现问题命令： pyinstaller -Fw app.py 然而，通过vscode运行，或者python app.py并没有报错，推测可以打包过程中有些依赖没有添加。 但是通过上述命令运行无法获取错误日志。 获取错误日志 去掉 -Fw 重新打包 pyinstaller app.py 命令行调用
【python】成功解决“Failed to execute script ‘pyiboot01_bootstrap‘ due to unhandled exception: Cannot load
keira674的博客
10-06 4328
可以尝试通过修改你的代码，使其能够在打包和开发环境中正确处理路径问题，类似于你之前分享的代码片段。在打包过程中创建的引导模块，通常它用于初始化应用程序的运行环境。如果它无法加载，可能意味着打包过程不完整或者打包出了问题。打包工具可能没有将某些模块或依赖项包含在内，导致打包后的可执行文件无法找到这些模块。通过这些步骤，你应该能够找出和解决“无法加载冻结模块”的问题。如果问题依旧，建议你通过打包后的日志信息进一步排查。文件）或其他系统资源，这些资源可能没有被打包进可执行文件中。
pyinstaller打出的EXE包执行时报错“failed to excute ”信息
weixin_30314793的博客
07-01 273
我的程序是selenium自动化脚本，打包时执行的是 Python pyinstaller -F --onefile -w XXX.py 这样打出的包执行后提示“failed to excute script xxx” 一直没想到是哪里出了问题，后来又仔细看了下打包参数 -F, –onefile 打包成一个exe文件。-D, –onedir 创建一个目录，包含exe文件，...
pyinstaller failed to execute script XXX
目标检测、LLM相关
03-25 2215
解决pyinstaller failed to execute script XXX问题
Failed to execute script ‘xxx‘ due to unhandled exception:No module named ‘ctypes‘
qq_43615820的博客
12-25 5442
【代码】Failed to execute script 'xxx' due to unhandled exception:No module named 'ctypes'
pyinstaller打包pynput：Failed to excute script ‘main‘ due to unhandled exception:No module named pynput
k903161661的博客
07-20 1008
搜索后发现可能是pynput版本过高导致的，将其版本降低至1.6.8。但并未解决，遂考虑直接将pynput这个包直接放置在项目所在目录下。再运行pyinstaller进行打包，问题解决。
已解决[1964] Failed to execute script ‘VRrify_code’ due to unhandled exception
热门推荐
努力让自己发光，对的人才能迎着光而来
12-13 5万+
已解决Python导包错误ImportError: DLL 1oad failed while importing, onnxruntime_pybind11_state: 参数错误。 [1964] Failed to execute script ‘VRrify_code’ due to unhandled exception!
paddleOCR打包后运行报警Failed to execute script 'main’due to unhandled exception!
04-23
<think>好的，我现在要解决用户的问题，关于PaddleOCR打包成exe后运行时出现的错误：“Failed to execute script main due to unhandled exception”。首先，我需要回忆一下用户提供的引用内容，看看有没有相关的线索。用户提到了几个引用，其中引用[1]和[3]都提到了模块缺失的问题，特别是自定义模块或者第三方库如pynput的版本问题。引用[2]则提到了即使打包没有报错，运行时也可能出现问题，可能与隐藏的导入或路径问题有关。 首先，PaddleOCR本身依赖较多，可能打包时没有正确包含所有依赖项。用户的问题可能涉及以下几个方面： 1. **模块缺失**：这是最常见的问题，特别是第三方库可能没有被正确打包。例如，auto_test是用户的自定义模块，但PaddleOCR可能依赖其他库，如paddle、numpy、opencv等，或者一些隐式导入的模块没有被PyInstaller检测到。 2. **动态链接库或数据文件缺失**：有些库需要额外的数据文件或动态链接库（DLL），这些可能在打包时没有被正确包含进去。比如，PaddlePaddle框架可能需要一些特定的动态库。 3. **路径问题**：打包后的exe运行时，工作目录可能与开发环境不同，导致资源文件（如模型文件、配置文件）无法正确加载。 4. **版本兼容性问题**：某些库的版本过高或过低可能导致兼容性问题，例如引用[3]中提到的pynput版本过高需要降级的情况。 接下来，我需要结合这些可能性，逐步分析解决方案： **第一步：检查模块是否完全打包** PyInstaller有时候无法自动检测所有的依赖，特别是动态导入或条件导入的模块。用户需要使用`--hidden-import`参数手动指定这些模块。例如，PaddleOCR可能用到的一些子模块，如`paddle.inference`等，可能需要显式导入。 **第二步：添加数据文件和资源** PaddleOCR在运行时可能需要加载模型文件、配置文件等资源。这些文件在开发环境中可能位于特定路径，但打包后exe会解压到临时目录，路径会变化。需要使用`--add-data`参数将这些资源文件包含进去，并在代码中正确处理路径。 **第三步：处理动态链接库** 某些依赖库可能需要动态链接库，例如CUDA相关的DLL，如果用户的环境使用了GPU，可能需要确保这些DLL也被正确打包，或者检查是否需要排除某些冲突的库。 **第四步：路径调整** 在代码中，需要确保所有文件路径都是相对于exe的临时目录。可以使用`sys._MEIPASS`来获取临时目录的正确路径，并据此调整资源文件的加载路径。 **第五步：版本兼容性检查** 检查PaddleOCR及其依赖库的版本是否与PyInstaller兼容。例如，某些库的最新版本可能存在打包问题，降级到旧版本可能解决。 **第六步：调试打包过程** 使用控制台模式打包（`-c`参数），运行exe时查看详细的错误信息，或者通过`--log-level DEBUG`参数获取打包时的详细日志，找出缺失的模块或资源。 **第七步：测试打包配置** 创建一个干净的虚拟环境，仅安装必要的依赖，然后进行打包测试，避免原有环境中的干扰因素。 现在，结合用户提供的引用，比如引用[3]中提到的降低pynput版本解决了问题，可能需要检查是否有类似的情况，比如PaddleOCR依赖的某个库版本过高，导致打包后无法加载。此外，引用[2]中提到即使打包成功，运行时也可能因路径问题出错，所以需要确保代码中的路径处理正确。 可能的解决方案步骤包括： 1. 使用PyInstaller的`--hidden-import`添加可能缺失的模块。 2. 使用`--add-data`包含模型文件和资源。 3. 在代码中使用`sys._MEIPASS`调整资源路径。 4. 检查依赖库版本，必要时降级。 5. 测试打包后的exe在控制台下的错误输出，以确定具体缺失的模块或文件。 最后，需要验证这些步骤是否有效，可能需要多次调整和测试，直到问题解决。</think>针对PaddleOCR打包后报错`Failed to execute script main due to unhandled exception`的问题，以下是系统级解决方案： ### 一、核心问题定位 此错误通常由**依赖模块缺失**或**资源路径错误**引起。PaddleOCR依赖动态加载的配置文件、模型文件和第三方库，PyInstaller默认打包可能无法完全捕获这些资源[^1][^3]。 --- ### 二、具体解决步骤 #### 1. 强制包含隐藏依赖 通过`--hidden-import`手动声明PaddleOCR的隐式依赖模块： ```bash pyinstaller -F main.py \ --hidden-import=pyclipper \ --hidden-import=lanms \ --hidden-import=imgaug \ --hidden-import=paddle.fluid.core ``` #### 2. 添加资源文件 使用`--add-data`包含模型文件和配置文件： ```bash pyinstaller -F main.py \ --add-data="inference_model/*:inference_model" \ --add-data="configs/*:configs" ``` 路径格式为`源路径:目标路径`，目标路径在exe运行时对应`sys._MEIPASS`临时目录[^2]。 #### 3. 代码路径适配 在Python代码中添加路径修正逻辑： ```python import sys import os if getattr(sys, 'frozen', False): base_dir = sys._MEIPASS else: base_dir = os.path.dirname(__file__) config_path = os.path.join(base_dir, 'configs/ocr_config.yml') ``` #### 4. 版本兼容性处理 通过`requirements.txt`锁定依赖版本： ``` paddlepaddle==2.3.2 paddleocr==2.6.1.3 pyinstaller==5.6.2 shapely==1.8.2 # 避免与pyclipper冲突 ``` #### 5. 调试模式打包 使用控制台模式观察具体报错： ```bash pyinstaller -c -D main.py # 生成控制台可执行文件 ``` --- ### 三、验证流程 1. 在`dist`目录执行`main.exe` 2. 观察控制台输出的具体缺失模块信息 3. 若出现新缺失模块，重复步骤1-2添加`--hidden-import` --- ### 四、典型错误场景 | 错误现象 | 解决方案 | |---------|----------| | `No module named 'paddle.inference'` | 添加`--hidden-import=paddle.inference` | | `Missing config file` | 检查`--add-data`路径格式 | | `DLL load failed` | 安装VC++ 2015-2022可再发行组件 | ---
评论 1
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

xiejava1018

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值