使用PyInstaller更新PyQt5应用可执行文件时出现WinError 5权限错误

问题详情 #

首次用PyInstaller打包PyQt5应用正常，但执行pyinstaller app.spec更新可执行文件时，确认删除dist目录内容后触发权限错误，完整栈跟踪如下：

WARNING: The output directory "C:\Users\zedon\Documents\GitHub\2022-Project-Scam-Buster\application\dist\app" and ALL ITS CONTENTS will be REMOVED! Continue? (y/N)y
On your own risk, you can use the option `--noconfirm` to get rid of this question.
11156 INFO: Removing dir C:\Users\zedon\Documents\GitHub\2022-Project-Scam-Buster\application\dist\app
Traceback (most recent call last):
  File "C:\users\zedon\appdata\local\programs\python\python39\lib\site-packages\PyInstaller\building\utils.py", line 446, in _make_clean_directory
    os.remove(path)
PermissionError: [WinError 5] Access is denied: 'C:\\Users\\zedon\\Documents\\GitHub\\2022-Project-Scam-Buster\\application\\dist\\app'

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "C:\users\zedon\appdata\local\programs\python\python39\lib\runpy.py", line 197, in _run_module_as_main  
    return _run_code(code, main_globals, None,
  File "C:\users\zedon\appdata\local\programs\python\python39\lib\runpy.py", line 87, in _run_code
    exec(code, run_globals)
  File "C:\Users\zedon\AppData\Local\Programs\Python\Python39\Scripts\pyinstaller.exe\__main__.py", line 7, in <module>
  File "C:\users\zedon\appdata\local\programs\python\python39\lib\site-packages\PyInstaller\__main__.py", line 178, in run
    run_build(pyi_config, spec_file, **vars(args))
  File "C:\users\zedon\appdata\local\programs\python\python39\lib\site-packages\PyInstaller\__main__.py", line 59, in run_build
    PyInstaller.building.build_main.main(pyi_config, spec_file, **kwargs)
  File "C:\users\zedon\appdata\local\programs\python\python39\lib\site-packages\PyInstaller\building\build_main.py", line 842, in main
    build(specfile, distpath, workpath, clean_build)
  File "C:\users\zedon\appdata\local\programs\python\python39\lib\site-packages\PyInstaller\building\build_main.py", line 764, in build
    exec(code, spec_namespace)
  File "app.spec", line 41, in <module>
    coll = COLLECT(
  File "C:\users\zedon\appdata\local\programs\python\python39\lib\site-packages\PyInstaller\building\api.py", line 864, in __init__
    shutil.rmtree(path)
  File "C:\users\zedon\appdata\local\programs\python\python39\lib\shutil.py", line 740, in rmtree    return _rmtree_unsafe(path, onerror)
  File "C:\users\zedon\appdata\local\programs\python\python39\lib\shutil.py", line 613, in _rmtree_unsafe      
    _rmtree_unsafe(fullname, onerror)  File "C:\users\zedon\appdata\local\programs\python\python39\lib\shutil.py", line 613, in _rmtree_unsafe      
    _rmtree_unsafe(fullname, onerror)
  File "C:\users\zedon\appdata\local\programs\python\python39\lib\shutil.py", line 613, in _rmtree_unsafe          _rmtree_unsafe(fullname, onerror)
  [Previous line repeated 1 more time]
  File "C:\users\zedon\appdata\local\programs\python\python39\lib\shutil.py", line 622, in _rmtree_unsafe          onerror(os.rmdir, path, sys.exc_info())
  File "C:\users\zedon\appdata\local\programs\python\python39\lib\shutil.py", line 620, in _rmtree_unsafe      
    os.rmdir(path)
PermissionError: [WinError 5] Access is denied: 'C:\\Users\\zedon\\Documents\\GitHub\\2022-Project-Scam-Buster\\application\\dist\\app\\PyQt5\\Qt5\\plugins\\iconengines'

原因确认 #

结合报错信息和你的猜测，核心原因通常是以下两种：

• 文件/目录被占用：旧的应用进程未完全关闭，或系统进程（如资源管理器预览、杀毒软件）锁定了PyQt5的插件文件（比如iconengines目录下的文件），导致PyInstaller无法删除。
• 权限限制：GitHub仓库目录或虚拟环境的权限设置导致当前用户没有足够权限删除目录；部分PyQt5打包后的文件被标记为只读，进一步阻碍删除操作。

微创解决方案 #

无需每次手动删除dist/build目录，按以下优先级尝试：

1. 释放被占用的文件 #

• 打开任务管理器，结束所有与你的应用相关的进程（包括后台运行的实例）。
• 关闭资源管理器中打开的dist/app目录窗口，避免文件被预览功能锁定。
• 临时关闭杀毒软件的实时防护（测试用），部分杀毒软件会扫描打包后的文件并锁定。

2. 自定义spec文件的清理逻辑 #

在app.spec开头添加自定义清理代码，自动处理只读文件和权限问题：

import os
import shutil
import stat

def handle_remove_readonly(func, path, exc_info):
    # 移除文件/目录的只读属性后重试删除
    os.chmod(path, stat.S_IWRITE)
    func(path)

# 在COLLECT之前手动清理目标dist目录
target_dist_dir = "dist/app"
if os.path.exists(target_dist_dir):
    shutil.rmtree(target_dist_dir, onerror=handle_remove_readonly)

修改后执行pyinstaller app.spec即可，自定义逻辑会绕过权限限制完成清理。

3. 临时指定新的输出目录 #

执行打包命令时用--distpath参数指定新的输出目录，避免删除旧目录：

pyinstaller app.spec --distpath dist_new

打包完成后再手动替换旧的dist/app目录（仅适合临时应急）。

4. 调整目录权限 #

• 右键点击项目根目录，选择「属性」→「安全」→「编辑」，确保当前用户拥有「完全控制」权限。
• 若使用虚拟环境，确认虚拟环境目录的权限未被系统限制。

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