使用FileTransform@1替换变量时遇InvalidRequestContent错误的解决步骤

1. 修正变量命名逻辑 #

FileTransform@1任务对JSON的替换基于节点路径匹配，你当前定义的parameters.tier变量会直接替换JSON中parameters.tier整个节点，把原本的{"value": "myTier"}替换成字符串"test"，破坏了Azure部署参数要求的结构（必须是包含value键的对象）。

需要把变量名改成tier.value，让任务精准替换parameters.tier.value字段，保留外层对象结构。

修改YAML中的变量定义：

variables:
  - group: myGroup
  - name: tier.value
    value: "$(tier)"

2. 验证转换后的JSON结构（可选但推荐） #

在FileTransform任务后添加PowerShell步骤，打印转换后的main.parameters.json内容，确认结构正确：

- task: PowerShell@2
  displayName: 'Check transformed parameters file'
  inputs:
    targetType: 'inline'
    script: |
      Get-Content 'bicep\main.parameters.json' | Write-Output

正确的转换后结构应该是：

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "franchisee": {
      "value": "myFranchisee"
    },
    "tier": {
      "value": "test"
    },
    "location": {
      "value": "myLocation"
    },
    "rg": {
      "value": "myRg"
    }
  }
}

3. 重新运行流水线 #

调整后，FileTransform任务会正确更新tier节点的value字段，保留符合Azure要求的参数结构，az deployment group what-if命令就能正常解析参数文件了。

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