Ubuntu容器中subprocess.check_output解析JSON类参数执行失败问题

问题核心是subprocess列表传参的引号规则与shell命令行的引号规则不匹配：

• 终端执行命令时，--fmust='[{"xxx"}]'里的单引号属于shell语法符号，作用是告诉shell不要拆分单引号内的空格、不解析特殊字符，shell实际执行命令时会自动剥掉这层单引号，传给elkq.py的参数是不带外层单引号的--fmust=[{"fields.buypass.com/name": "id-pro-_VERT_-*"}, {"bps.application": "*-_TESTENV_"}]。
• 你当前传给subprocess.check_output的exe列表中，对应的参数是'--fmust=\'[{"fields.buypass.com/name": "id-pro-_VERT_-*"}, {"bps.application": "*-_TESTENV_"}]\''，等于把shell专用的单引号也作为参数内容的一部分传给了程序，导致JSON参数解析失败返回255错误。另外你的--index、--fany参数也存在同样的多余单引号问题，只是未触发解析错误而已。

• 优先使用列表形式传参（无shell注入风险）：直接删除所有手动添加的shell专用单引号即可，subprocess会自动处理空格、特殊字符的转义，示例写法：

# 先定义fmust参数值，不需要加外层单引号
fmust_val = r'[{"fields.buypass.com/name": "id-pro-_VERT_-*"}, {"bps.application": "*-_TESTENV_"}]'
exe = [
    './bin/elkq.py',
    '--env=test',
    '--vertical=trk',
    '--index=bps-trace-*', # 去掉外层单引号
    '--testenv=test12',
    '--fields=@timestamp,message,bps.application',
    '--aggs=bps.application',
    '--start=now-4h',
    '--end=now',
    '--json',
    '--fany=("error")', # 去掉外层单引号
    f'--fmust={fmust_val}' # 直接拼接，不需要加单引号
]
out = subprocess.check_output(exe)

• 特殊场景需用shell模式执行（有注入风险，不推荐）：把整个命令拼成完整字符串，设置shell=True即可保留终端的引号写法：

cmd = '''./bin/elkq.py --env=test --vertical=trk --index='bps-trace-*' --testenv=test12 --fields=@timestamp,message,bps.application --aggs=bps.application --start=now-4h --end=now --json --fany='("error")' --fmust='[{"fields.buypass.com/name": "id-pro-_VERT_-*"}, {"bps.application": "*-_TESTENV_"}]' '''
out = subprocess.check_output(cmd, shell=True)

• 捕获CalledProcessError时打印e.stderr和e.cmd，直接查看子进程输出的具体错误信息、实际执行的参数列表，大部分参数类问题可直接定位。
• 在目标脚本（此处为elkq.py）开头添加入参打印代码，分别用subprocess和终端执行脚本，对比参数差异快速定位不匹配项：

import sys
print("received args:", sys.argv)

• 若涉及复杂JSON、特殊字符参数，可先对参数做base64编码传递，接收端再解码，彻底规避转义冲突。

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