Bicep部署WebTest时JSON解析失败问题排查求助

错误原因分析 #

错误提示显示JSON解析失败，因为属性名Id未被双引号包裹，但你传入的locations变量格式是合法JSON。问题出在参数传递过程中格式被破坏，导致Bicep接收到的是未正确格式化的字符串（而非合法JSON数组）。

解决步骤 #

1. 显式约束参数类型（增强校验） #

在Bicep中给testLocations参数添加更具体的类型约束，提前校验传入的数组结构：

param testLocations array<{ Id: string }>
// 其他参数定义（testName、testFrequency等）保持不变

resource availabilityTest 'Microsoft.Insights/webtests@2022-06-15' = {
  // 现有资源配置代码不变
}

此操作会让Bicep在编译阶段检查参数结构，提前发现格式问题。

2. 使用参数文件传递数组（推荐） #

避免命令行直接传递复杂数组，改用JSON参数文件保证格式绝对正确：
创建parameters.json文件：

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "testLocations": {
      "value": [
        {"Id": "us-tx-sn1-azr"},
        {"Id": "us-ca-sjc-azr"},
        {"Id": "us-il-ch1-azr"},
        {"Id": "us-va-ash-azr"},
        {"Id": "us-fl-mia-edge"}
      ]
    },
    "testName": {"value": "your-test-name"},
    "testFrequency": {"value": 300},
    "testTimeout": {"value": 30},
    "testURL": {"value": "https://your-target-url.com"},
    "testExpectedHttpStatusCode": {"value": 200},
    "testExpectedContent": {"value": "expected-content-string"},
    "appInsightsId": {"value": "/subscriptions/xxx/resourceGroups/xxx/providers/microsoft.insights/components/xxx"}
  }
}

部署时指定参数文件：

az deployment group create --resource-group your-rg --template-file your-template.bicep --parameters parameters.json

3. 命令行传递数组时正确转义 #

如果必须在命令行传递数组，需根据操作系统正确转义双引号：

• Windows（PowerShell）：

az deployment group create --resource-group your-rg --template-file your-template.bicep --parameters testLocations='[{"Id": "us-tx-sn1-azr"},{"Id": "us-ca-sjc-azr"},{"Id": "us-il-ch1-azr"},{"Id": "us-va-ash-azr"},{"Id": "us-fl-mia-edge"}]'

• Linux/macOS（Bash）：

az deployment group create --resource-group your-rg --template-file your-template.bicep --parameters testLocations='[{\"Id\": \"us-tx-sn1-azr\"},{\"Id\": \"us-ca-sjc-azr\"},{\"Id\": \"us-il-ch1-azr\"},{\"Id\": \"us-va-ash-azr\"},{\"Id\": \"us-fl-mia-edge\"}]'

4. 验证Bicep编译输出 #

执行az bicep build --file your-template.bicep编译模板，检查生成的ARM JSON中Locations字段是否正确引用参数，确保无格式错误。

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