Azure DevOps Pipeline向ARM模板传递对象数组参数报错解决

Azure DevOps 图形化生成管道的ARM模板部署任务中，「覆盖模板参数」输入框默认会将所有填入的参数值按字符串类型解析，哪怕手动输入JSON结构的内容，也会被整体序列化为字符串传入，和你ARM模板中tags参数要求的Object类型不匹配，最终触发类型校验错误。

根据你的tags值是固定还是动态变化，选对应方案即可：

方案1：直接在参数框传转义JSON（适合固定标签场景，无需额外配置） #

不需要新增其他任务步骤，直接在「Override template parameters」输入框中按如下格式传值：

• 所有普通字符串参数（比如rgName、rgLocation）保持原有写法不变
• tags参数的JSON对象整体用单引号包裹，对象内部所有键、值的双引号前加反斜杠\转义，不要加多余换行
  完整示例：

-rgName myResourceGroup -rgLocation chinaeast2 -tags '{\"env\":\"prod\",\"business\":\"finance\",\"owner\":\"ops-team\"}'

上面示例中传入的tags实际解析后就是标准对象：

{
  "env": "prod",
  "business": "finance",
  "owner": "ops-team"
}

方案2：变量存值+JSON转换（适合动态标签场景） #

如果tags值需要根据分支、构建环境动态调整，用这个方案灵活性更高：

1. 先在管道的变量配置页定义变量，比如命名为armTags，变量值直接填标准JSON格式的标签对象，不需要做转义：

{"env":"test","business":"rd","owner":"dev-team"}

如果tags需要动态生成，也可以在前置PowerShell/Bash脚本中构造完标签对象后，通过日志命令赋值给该变量：

# PowerShell示例
$tags = @{env="test";business="rd";owner="dev-team"} | ConvertTo-Json -Compress
Write-Host "##vso[task.setvariable variable=armTags]$tags"

2. 回到ARM部署任务的覆盖参数配置框，引用变量时用内置JSON()函数做类型转换，示例：

-rgName $(rgName) -rgLocation $(rgLocation) -tags [JSON('$(armTags)')]

这里的JSON()是管道任务内置的转换函数，会把传入的字符串解析为标准ARM对象类型，不会被识别为普通字符串。

• 不要直接在参数框写无转义的JSON结构，比如-tags {"env":"test"}，这种写法一定会被识别为字符串触发报错
• 如果你实际需要传入的是对象数组而非键值对对象，请先把ARM模板中tags参数的type从object改为array，传值逻辑和上述方案一致，转义后的数组示例：-tags '[{\"tagKey\":\"env\",\"tagValue\":\"test\"}]'

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