subprocess.run设置check=True时pkill加|| true仍报错的原因及解决方法

你遇到的报错核心原因是shell=True启动的临时shell进程被自己执行的pkill命令误杀了：

• 当你设置shell=True时，subprocess会先启动一个shell进程，执行的完整命令为sh -c "pkill -f non_existent_process_name || true"
• 这个shell进程的完整命令行参数里包含了non_existent_process_name字符串，刚好被pkill -f的规则匹配到
• pkill会直接向匹配到的shell进程发送SIGTERM信号，导致shell进程在执行到|| true之前就被终止，自然不会返回0退出码
• check=True检测到命令异常终止，就抛出了CalledProcessError

你在终端直接执行命令时不会触发这个问题，是因为交互式shell的进程命令行不会包含你输入的pkill命令串，不会被匹配规则命中。

有两种常用的修改方式，都可以解决问题：

方案1：禁用shell=True，手动处理退出码 #

pkill的合法退出码只有三种：0=成功发信号给匹配进程、1=没有匹配到进程、≥2=命令执行出错。我们可以直接关闭check校验，手动判断返回码即可：

import subprocess
result = subprocess.run(
    ["pkill", "-f", "non_existent_process_name"],
    check=False
)
# 仅当返回码≥2时才抛出异常
if result.returncode >= 2:
    result.check_returncode()

这种方案更安全，也避免了shell注入的风险，更推荐使用。

方案2：调整匹配规则，避免误杀shell进程 #

如果一定要用shell逻辑，可以修改pkill的匹配参数，让匹配串不会出现在shell的命令行参数里，比如拆分字符串拼接：

import subprocess
subprocess.run(
    "pkill -f 'non_existent''_process_name' || true",
    shell=True,
    check=True
)

shell会自动拼接两个相邻的字符串，pkill拿到的还是完整的匹配规则，但shell的命令行里不会出现完整的non_existent_process_name串，不会被误匹配。

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