PyInstaller打包Tkinter应用后subprocess调用外部脚本失败求助

我有一个用于Tkinter GUI应用的函数，通过subprocess启动其他带独立GUI的脚本作为子进程，在PyCharm中运行正常，但用PyInstaller打包成exe后无法打开目标脚本，控制台无错误输出。

核心代码 #

启动子进程的函数 #

def run_external_script(script_center_root, script_name, *args):

    script_center_root.withdraw()
    script_center_root.protocol("WM_DELETE_WINDOW", lambda: None)  # Disable close button

    base_path = getattr(sys, '_MEIPASS', os.path.dirname(os.path.abspath(__file__)))
    script_path = os.path.join(base_path, script_name)

    try:
        print("process started")
        process = subprocess.Popen([python_executable, script_path, *args], shell=True, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, stdin=subprocess.PIPE )
        #process.wait()
        print("process stopped")

    except subprocess.CalledProcessError as e:
        print(f"Error: Subprocess for '{script_name}' failed with exit code {e.returncode}")
        print(f"Standard Output:\n{e.stdout}")
        print(f"Error Output:\n{e.stderr}")
        messagebox.showerror("Error", f"Could not run script: {script_name}\n{e.stderr}")
    finally:
        script_center_root.protocol("WM_DELETE_WINDOW", lambda: close_window(script_center_root))  # Re-enable close button
        reopen_main_window(script_center_root)

PyInstaller的.spec文件 #

a = Analysis(
    ['main.py'],
    pathex=['.'],
    binaries=[],
    datas=[
        ('XML_to_xlsx.py', '.'),
        ('xlsx_to_PIES.py', '.'),
        ('xlsx_to_ACES.py', '.'),
        ('aces_xlsx_expand.py', '.'),
        ('aces_xlsx_rollup.py', '.'),
        ('transpose_xlsx.py', '.')
    ],
    hiddenimports=['openpyxl','pandas', 'lxml'],
    hookspath=[],
    hooksconfig={},
    runtime_hooks=[],
    excludes=[],
    noarchive=False,
    optimize=0,
)
pyz = PYZ(a.pure)

exe = EXE(
    pyz,
    a.scripts,
    a.binaries,
    a.zipfiles,
    a.datas,
    [],
    name='main',
    debug=False,
    bootloader_ignore_signals=False,
    strip=False,
    upx=True,
    console=True,
    disable_windowed_traceback=False,
    argv_emulation=False,
    target_arch=None,
    codesign_identity=None,
    entitlements_file=None,
)
coll = COLLECT(
    exe,
    a.scripts,
    a.binaries,
    a.datas,
    strip=False,
    upx=True,
    upx_exclude=[],
    name='main',
)

1. 修正Python解释器路径 #

打包成exe后，系统不一定存在全局Python环境，python_executable可能指向无效路径：

• 替换为sys.executable，它会指向当前运行的exe文件，能正确调用PyInstaller打包环境中的Python解释器
• 同时关闭shell=True，避免路径解析异常并提升安全性，修改后的调用：

process = subprocess.Popen([sys.executable, script_path, *args], shell=False, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, stdin=subprocess.PIPE )

2. 验证脚本路径有效性 #

打包后sys._MEIPASS是临时解压目录，需确认脚本被正确放置：

• 在script_path赋值后添加打印语句，输出实际路径：

print(f"Script path: {script_path}")

• 运行打包后的exe，检查控制台输出的路径是否存在对应脚本。若路径错误，核对.spec文件中datas配置，确保脚本被正确收集。

3. 捕获子进程真实错误 #

当前代码仅捕获CalledProcessError，但Popen不会触发该异常，导致错误信息丢失：

• 改用communicate()读取子进程的输出和错误：

process = subprocess.Popen([sys.executable, script_path, *args], shell=False, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True)
stdout, stderr = process.communicate()
print(f"Subprocess stdout: {stdout}")
print(f"Subprocess stderr: {stderr}")
if process.returncode != 0:
    print(f"Subprocess failed with code {process.returncode}")
    messagebox.showerror("Error", f"Could not run script: {script_name}\n{stderr}")

通过这种方式能获取子进程的真实错误，比如依赖缺失、路径错误等。

4. 确认依赖打包完整性 #

子脚本用到的openpyxl、pandas等库，需确保在主程序的hiddenimports中声明，若子脚本有额外依赖，需补充到hiddenimports列表。

5. 尝试子脚本单独打包 #

将子脚本单独打包为exe，修改主函数直接调用子exe文件：

• 调整script_path为子exe的路径，调用改为：

process = subprocess.Popen([script_path, *args], shell=False)

这种方式无需依赖外部Python解释器，能避免环境兼容问题。

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