PyInstaller打包含patoolib的Python脚本运行报WinError6错误如何解决

错误原因 #

该报错的核心触发逻辑为：当你使用--windowed或--noconsole参数通过PyInstaller打包Windows程序时，生成的可执行文件不会创建控制台窗口，也就没有分配标准输入(stdin)、标准输出(stdout)、标准错误(stderr)三个系统句柄。而patoolib内部调用subprocess执行外部解压命令时，默认会继承父进程的这三个句柄，找不到对应句柄就会抛出OSError: [WinError 6] 无效句柄异常。
部分场景下也可能是patoolib无法找到系统中安装的7z解压程序导致该错误。

可用修复方案 #

• 方案1：调整patoolib调用参数，显式重定向输入输出
  无需修改打包参数，仅调整代码，显式告诉subprocess使用空的输入输出流即可：

import patoolib
import subprocess

patoolib.extract_archive(
    "test.7z",
    interactive=False,
    verbosity=-1,
    stdin=subprocess.DEVNULL,
    stdout=subprocess.DEVNULL,
    stderr=subprocess.DEVNULL
)

• 方案2：调整PyInstaller打包参数
  如果你不需要隐藏控制台窗口，打包时去掉--windowed/--noconsole参数，生成带控制台的exe即可直接解决该问题。

• 方案3：内置7z程序打包，避免依赖系统环境
  patoolib本身不包含解压逻辑，依赖外部7z程序执行操作。你可以提前将官方的7z.exe和7z.dll放到项目目录，打包时将两个文件一同打入exe，同时代码中指定7z的路径：

import sys
import os
import patoolib
import subprocess

def get_resource_path(relative_path):
    if getattr(sys, '_MEIPASS', False):
        base_path = sys._MEIPASS
    else:
        base_path = os.path.abspath(".")
    return os.path.join(base_path, relative_path)

seven_zip_path = get_resource_path("7z.exe")
patoolib.extract_archive(
    "test.7z",
    program=seven_zip_path,
    interactive=False,
    verbosity=-1,
    stdin=subprocess.DEVNULL,
    stdout=subprocess.DEVNULL,
    stderr=subprocess.DEVNULL
)

打包时使用如下命令：
pyinstaller --add-binary "7z.exe;." --add-binary "7z.dll;." 你的脚本名称.py

• 方案4：替换为纯Python解压库，规避外部进程调用
  不想处理外部依赖和句柄问题，可以直接换用纯Python实现的py7zr库处理7z解压，全程不需要调用外部进程：
  首先安装依赖：pip install py7zr
  代码示例：

import py7zr

with py7zr.SevenZipFile("test.7z", mode="r") as archive:
    archive.extractall()

直接按正常流程打包即可，不会出现句柄相关报错。

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