PyInstaller无控制台运行exe报WinError 6：句柄无效问题求助

我碰到过一模一样的问题！这个WinError 6的根源是PyInstaller的-w参数让你的Python程序没有关联控制台窗口，导致subprocess调用时默认继承的stdin/stdout/stderr句柄都是无效的——patool的run函数只在低verbosity时重定向了stdout，但没处理stdin和stderr，这就触发了句柄无效的错误。

下面给你几个经过验证的解决方法，按推荐程度排序：

1. 给patool做Monkey Patch（推荐，不修改依赖源码） #

在你的主脚本script.py最开头添加这段代码，替换patool的run函数，专门处理无控制台场景：

import patoolib.util
import subprocess
import os
import sys

def patched_run(cmd, verbosity=0, **kwargs):
    """Patched run function to fix windowless subprocess calls"""
    # 保留patool原有的日志输出逻辑
    if verbosity >= 0:
        patoolib.util.log_info("running %s" % " ".join(map(patoolib.util.shell_quote_nt, cmd)))
    if kwargs:
        if verbosity >= 0:
            patoolib.util.log_info(" with %s" % ", ".join("%s=%s" % (k, patoolib.util.shell_quote(str(v)))
                for k, v in kwargs.items()))
    if kwargs.get("shell"):
        cmd = " ".join(cmd)
    
    # 判断是否处于无控制台模式（stdout不是终端）
    if sys.platform == 'win32' and not sys.stdout.isatty():
        # 重定向所有标准流到/dev/null，避免无效句柄
        with open(os.devnull, 'wb') as devnull:
            kwargs.setdefault('stdin', devnull)
            kwargs.setdefault('stdout', devnull)
            kwargs.setdefault('stderr', devnull)
            # 添加startupinfo确保子进程也不弹出窗口
            startupinfo = subprocess.STARTUPINFO()
            startupinfo.dwFlags |= subprocess.STARTF_USESHOWWINDOW
            startupinfo.wShowWindow = subprocess.SW_HIDE
            kwargs.setdefault('startupinfo', startupinfo)
            res = subprocess.call(cmd, **kwargs)
    else:
        # 正常模式下保留patool原有的逻辑
        if verbosity < 1:
            with open(os.devnull, 'wb') as devnull:
                kwargs['stdout'] = devnull
                res = subprocess.call(cmd, **kwargs)
        else:
            res = subprocess.call(cmd, **kwargs)
    return res

# 替换patool的run函数
patoolib.util.run = patched_run

这个方法的好处是不用修改patool的源码，打包时依然可以用-w参数，而且能处理所有patool调用subprocess的场景（包括你提到的后续subprocess.popen()）。

2. 隐藏控制台而非用-w参数（简单易行） #

如果你不想修改代码逻辑，可以放弃-w参数，转而在主脚本开头用Windows API隐藏控制台窗口：

import ctypes
import sys

if sys.platform == 'win32':
    # 获取控制台窗口句柄并隐藏
    console_handle = ctypes.windll.kernel32.GetConsoleWindow()
    if console_handle:
        ctypes.windll.user32.ShowWindow(console_handle, 0)

打包时用正常的PyInstaller命令（不带-w），运行时控制台会短暂闪一下然后消失，subprocess因为能继承到有效的控制台句柄，就不会触发WinError 6。而且这个方法不影响开机启动——之前你说的保留控制台再隐藏导致无法开机启动，可能是用了错误的时机调用隐藏代码，这个放在脚本开头的方法是可靠的。

3. 修改patool的util.py源码（彻底解决，但需维护） #

直接修改你环境中patool的util.py文件，把run函数的标准流重定向逻辑改得更彻底：
找到原来的这段代码：

if verbosity < 1:
    # hide command output on stdout
    with open(os.devnull, 'wb') as devnull:
        kwargs['stdout'] = devnull
        res = subprocess.call(cmd, **kwargs)
else:
    res = subprocess.call(cmd, **kwargs)

替换成：

import sys
with open(os.devnull, 'wb') as devnull:
    # 无控制台时必须重定向所有标准流
    kwargs.setdefault('stdin', devnull)
    kwargs.setdefault('stdout', devnull if verbosity < 1 else None)
    kwargs.setdefault('stderr', devnull if verbosity < 1 else None)
    
    # Windows下添加startupinfo避免子进程弹窗
    if sys.platform == 'win32':
        startupinfo = subprocess.STARTUPINFO()
        startupinfo.dwFlags |= subprocess.STARTF_USESHOWWINDOW
        startupinfo.wShowWindow = subprocess.SW_HIDE
        kwargs.setdefault('startupinfo', startupinfo)
    
    res = subprocess.call(cmd, **kwargs)

这个方法能彻底修复patool在无控制台环境下的问题，但如果之后更新patool，你需要重新修改这段代码。

我自己用第一种方法解决了问题，打包后的无控制台程序完全正常，patool调用各种压缩工具都没再出现错误。

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