subprocess.run调用外部脚本时参数传递异常问题排查

问题翻译 #

我编写了如下Python代码用于调用外部汇编工具：

command_assembly = f'{self.INPUT_ASSEMBLY_SRC}{self.file} ' \
    f'{self.ASSEMBLER} {self.ONLY_ASSEMBLY} {self.MIN_PARAMS} ' \
    f'{self.CUT_OFF} {cutoff} '\
    f'-o out'

result = subprocess.run([self.APP_ASSEMBLY, command_assembly], capture_output=True, text=True)

测试时发现subprocess.run方法仅能识别一个参数，无法正确解析包含多个参数的完整命令字符串，但该命令字符串在终端中执行时完全正常。请问这段代码存在什么问题？

你把所有命令参数拼接成了单个字符串，并将其作为列表的第二个元素传给subprocess.run。这种写法会让子进程把整个字符串当作唯一一个参数处理，而不是拆分出多个独立的参数。终端能正常执行是因为shell会自动帮你拆分参数，但subprocess.run默认不会做这个解析。

正确的做法是将每个参数拆分为列表中的独立元素，不要拼接成单个字符串：

# 逐个拆分参数，构建参数列表
command_args = [
    self.APP_ASSEMBLY,
    f'{self.INPUT_ASSEMBLY_SRC}{self.file}',
    self.ASSEMBLER,
    self.ONLY_ASSEMBLY,
    self.MIN_PARAMS,
    self.CUT_OFF,
    str(cutoff),  # 确保参数为字符串类型
    '-o',
    'out'
]

result = subprocess.run(command_args, capture_output=True, text=True)

• 不建议通过设置shell=True来解决问题：这会引入shell注入风险（尤其当参数包含用户输入时），同时跨平台兼容性会下降，不同shell的参数解析规则存在差异。
• 所有参数必须是字符串类型，如果cutoff是数字类型，记得转换为字符串后再加入列表。

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