PyInstaller生成的exe中subprocess模块无法正常运行的问题排查

我来帮你排查这个问题，这种PyInstaller打包后subprocess卡住的情况我碰到过好几次，主要有几个常见原因和对应的解决办法：

1. 外部EXE的路径找不到了 #

当你用-F参数把程序打包成单文件时，PyInstaller会在运行时把整个程序解压到系统临时目录（比如Windows的%TEMP%\_MEIxxxxxx这类随机命名的文件夹）。如果你的EXE变量是相对路径（比如"./xxx.exe"），那打包后的程序会去临时目录里找这个外部EXE，自然找不到，导致subprocess一直卡在启动进程的步骤上。

解决办法：

• 把外部EXE和打包后的exe放在同一目录，然后用代码获取当前运行程序的绝对路径来拼接外部EXE的位置：

  import os
  import sys
  
  # 判断当前是开发环境还是打包后的环境
  if getattr(sys, 'frozen', False):
      # 打包成exe后的运行目录
      current_dir = os.path.dirname(sys.executable)
  else:
      # PyCharm里的开发目录
      current_dir = os.path.dirname(os.path.abspath(__file__))
  
  # 拼接外部EXE的绝对路径
  EXE_PATH = os.path.join(current_dir, "你的外部exe文件名.exe")
  

• 如果你想把外部EXE直接打包进单文件里，可以用PyInstaller的--add-data参数，比如：pyinstaller -i"icon.ico" -w -F --add-data "xxx.exe;." script.py，然后在代码里用同样的方式获取打包后的路径。

2. PIPE管道缓冲导致的阻塞 #

当你用stdout=subprocess.PIPE（或者check_output）同时开启shell=True时，如果外部程序输出的内容较多，管道缓冲会被填满，子进程会暂停输出等待父进程读取，而父进程如果没主动去读取管道，就会陷入互相等待的死锁状态，看起来就是无响应。

解决办法：

• 如果你不需要捕获输出，直接去掉stdout=subprocess.PIPE参数，让外部程序的输出直接走系统默认输出（如果用了-w参数看不到控制台，可以先去掉-w调试，或者把输出写到日志文件里）。
• 如果必须捕获输出，一定要用communicate()方法来读取管道内容，还可以设置超时防止无限等待：

  import subprocess
  from subprocess import Popen, PIPE
  
  s = Popen([EXE_PATH, files, 'command'], shell=True, stdout=PIPE, stderr=PIPE)
  # 读取输出，设置30秒超时
  stdout, stderr = s.communicate(timeout=30)
  # 解码输出内容（根据实际编码调整，比如gbk）
  print(stdout.decode('utf-8'))
  print(stderr.decode('utf-8'))
  

• 另外，如果你的命令不需要用到shell的特性（比如通配符、环境变量展开），建议把shell=True改成shell=False，这样不仅更稳定，还能避免一些shell带来的额外问题，前提是EXE_PATH必须是绝对路径，参数列表要正确拆分。

3. 权限或杀毒软件拦截 #

打包后的exe有时候会被杀毒软件当成可疑程序，导致subprocess启动外部进程被拦截；或者程序运行的目录没有足够的读写权限，也会导致进程启动失败。

解决办法：

• 暂时关闭杀毒软件或者把打包后的exe添加到信任列表，测试是否是拦截问题。
• 不要把exe放到C盘根目录这类需要管理员权限的位置，或者右键选择“以管理员身份运行”试试。

调试小技巧 #

建议先去掉-w参数打包，这样运行exe时会弹出控制台，能看到subprocess的错误提示（比如“找不到文件”“权限不足”之类的），方便快速定位问题。打包命令改成：

pyinstaller -i"icon.ico" -F script.py

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