AWS CloudFormation deploy的--parameter-overrides参数传递问题排查

1. Shell 空白字符拆分与参数传递冲突 #

你用jq将JSON转为Key=Value格式时，若参数值包含空格、制表符等空白字符，shell会自动将这些空白作为参数分隔符，把原本完整的Key2=Hello World拆成Key2=Hello和World两个独立参数。AWS CLI v1收到后会认为Key2只被赋值了Hello，而World是无关联的无效参数，直接触发Parameters: [Key2] must have values错误。

哪怕你用引号包裹整个参数串（如"Key1=Val1 Key2=Hello World"），CLI v1的解析逻辑也无法正确识别引号内的空格——它会把整个引号内容当成单一字符串，再按空格强制拆分，依然会破坏带空格的参数值结构。而JSON字符串格式是整体传递，CLI直接解析JSON结构，完全绕开了shell的拆分逻辑，所以不会出问题。

2. AWS CLI v1 参数解析的固有局限 #

AWS CLI v1基于argparse实现参数解析，对于--parameter-overrides，它期望的是多个独立的命令行参数（即Key1=Val1 Key2=Val2这种直接在命令行罗列的形式），而非一个包含所有键值对的单一字符串。

比如你通过变量传递拼接后的字符串：

PARAMS=$(jq -r '. | to_entries | map("\(.key)=\(.value)") | join(" ")' params.json)
aws cloudformation deploy --parameter-overrides "$PARAMS"

此时CLI v1会把$PARAMS当作一个参数处理，再自行拆分键值对，但它的拆分逻辑只会按空格分割，完全无视值内的空格或引号，自然会导致参数解析错误。而CLI v2针对这个问题做了优化，但你使用的是v1，无法受益于该改进。

3. 特殊字符引发的解析异常 #

如果你的JSON参数值包含=、换行符或其他特殊字符，jq输出的字符串会直接保留这些字符。比如值为a=b时，jq输出Key2=a=b，CLI v1会错误地将其解析为键Key2=a、值b，导致参数匹配完全偏离预期，同样触发验证错误。

而你用xargs解决问题的核心原因是：xargs会正确识别引号、按换行/空格（智能区分值内空格）将字符串拆分为多个独立参数，再传递给CLI v1，完全符合它期望的参数格式，自然能正常解析。

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