如何终止卡住的Python Subprocess.run()进程？

首先明确：你的subprocess.run卡住大概率是因为子进程的stdout/stderr缓冲被填满，导致进程阻塞等待父进程读取输出。这种情况下单纯依赖超时机制可能失效，因为进程根本没在处理信号，而是卡在IO上。下面是可靠的处理方案：

核心思路 #

放弃直接用subprocess.run的timeout参数，改用subprocess.Popen手动管理进程，同时做到两点：

1. 实时读取子进程的输出，避免缓冲阻塞
2. 用独立线程或定时器监控进程运行时间，超时后强制终止整个进程树（因为你用了shell=True，会生成shell子进程，只杀shell进程没用）

可靠实现代码 #

方案1：纯标准库实现（线程读输出+进程组终止） #

import subprocess
import threading
import os
import signal

def run_cmd_with_timeout(cmd, cwd=None, timeout=30):
    proc = subprocess.Popen(
        cmd,
        text=True,
        shell=True,
        cwd=cwd,
        stderr=subprocess.STDOUT,
        stdout=subprocess.PIPE,
        start_new_session=True  # 创建新进程组，方便后续杀死整个树
    )

    # 线程函数：实时读取输出，避免缓冲填满导致阻塞
    output = []
    def read_output():
        for line in iter(proc.stdout.readline, ''):
            output.append(line)
        proc.stdout.close()

    output_thread = threading.Thread(target=read_output)
    output_thread.start()

    # 等待进程结束或超时
    output_thread.join(timeout)
    if output_thread.is_alive():
        # 超时：杀死整个进程组（包括shell和它启动的子进程）
        os.killpg(os.getpgid(proc.pid), signal.SIGKILL)
        proc.wait()
        output_thread.join()
        return ''.join(output), True  # 返回输出和超时标记
    else:
        return ''.join(output), False

说明：

• start_new_session=True让子进程成为新会话的领头进程，os.killpg可以一次性杀掉整个进程树
• 用线程实时读取输出，彻底避免缓冲阻塞导致的进程挂起

方案2：用psutil库简化进程树处理（跨平台） #

如果可以安装第三方库，psutil能更简洁地遍历并终止所有子进程：

import subprocess
import psutil
import threading
import time

def run_cmd_with_timeout(cmd, cwd=None, timeout=30):
    proc = subprocess.Popen(
        cmd,
        text=True,
        shell=True,
        cwd=cwd,
        stderr=subprocess.STDOUT,
        stdout=subprocess.PIPE
    )

    # 线程读取输出
    output = []
    def read_output():
        for line in iter(proc.stdout.readline, ''):
            output.append(line)
        proc.stdout.close()

    output_thread = threading.Thread(target=read_output)
    output_thread.start()

    # 监控超时
    start_time = time.time()
    while proc.poll() is None:
        if time.time() - start_time > timeout:
            # 遍历并杀死所有子进程，最后杀死父进程
            parent = psutil.Process(proc.pid)
            for child in parent.children(recursive=True):
                child.kill()
            parent.kill()
            break
        time.sleep(0.1)
    output_thread.join()
    return ''.join(output), proc.returncode is not None and proc.returncode < 0

关键注意事项 #

• 永远不要在stdout=PIPE/stderr=PIPE的情况下，不读取输出就等待进程结束，这是最常见的卡住原因
• 用shell=True时必须终止整个进程树，否则shell的子进程会变成孤儿进程继续运行
• 如果不需要shell解析命令，尽量去掉shell=True，这样直接杀死proc.pid即可，更稳定

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