无法通过Bicep脚本为Azure App Service添加带冒号的应用设置

问题背景 #

配置Azure App Service的嵌套应用设置（对应appsettings.json中的层级结构，用冒号:分隔）时，Azure门户手动添加正常，但通过Bicep脚本配置失败。尝试过两种配置方式：

尝试的脚本1：独立配置appsettings资源 #

var dbConnectionString = 'test connection'

resource siteconfigWebjob 'Microsoft.Web/sites/config@2022-03-01' = {
  parent: windowsAppService
  name: 'appsettings'
  properties: {
    'ConnectionStrings:DefaultConnection': dbConnectionString
  }
}

尝试的脚本2：在App Service资源内直接配置 #

resource windowsAppService 'Microsoft.Web/sites@2022-03-01' = {
  name: webjobAppServiceName
  location: resourceGroupLocation
  kind: 'app'
  properties: {
    serverFarmId: windowsappServicePlan.id
    siteConfig: {
      appSettings: [
        {
          name: 'AzureWebJobsStorage'
          value: storageConnectionString
        }
        {
          name: 'MaxCsvFileSizeInBytes'
          value: '4194304'
        }
      ]
    }
  }
}

正确配置方法 #

嵌套结构的应用设置可直接通过Section:Key格式定义，两种配置方式的正确写法如下：

方式1：独立appsettings资源配置 #

键名需用单引号包裹（Bicep要求带特殊字符的对象键明确为字符串），同时确保父App Service资源已正确定义：

var dbConnectionString = 'test connection'

// 先定义App Service资源
resource windowsAppService 'Microsoft.Web/sites@2022-03-01' = {
  name: webjobAppServiceName
  location: resourceGroupLocation
  kind: 'app'
  properties: {
    serverFarmId: windowsappServicePlan.id
  }
}

// 配置嵌套应用设置
resource siteconfigWebjob 'Microsoft.Web/sites/config@2022-03-01' = {
  parent: windowsAppService
  name: 'appsettings'
  properties: {
    'ConnectionStrings:DefaultConnection': dbConnectionString
    'AppSettings:Level1:Level2': 'multi-level value' // 多层嵌套示例
  }
}

方式2：App Service资源内直接配置 #

在appSettings数组中添加嵌套键的配置项，名称直接使用Section:Key格式：

resource windowsAppService 'Microsoft.Web/sites@2022-03-01' = {
  name: webjobAppServiceName
  location: resourceGroupLocation
  kind: 'app'
  properties: {
    serverFarmId: windowsappServicePlan.id
    siteConfig: {
      appSettings: [
        {
          name: 'AzureWebJobsStorage'
          value: storageConnectionString
        }
        {
          name: 'MaxCsvFileSizeInBytes'
          value: '4194304'
        }
        // 添加嵌套配置
        {
          name: 'ConnectionStrings:DefaultConnection'
          value: dbConnectionString
        }
        {
          name: 'AppSettings:Level1:Level2'
          value: 'multi-level value'
        }
      ]
    }
  }
}

失败排查要点 #

• API版本：使用稳定版API（如2022-03-01及以上），旧版本可能存在兼容性问题。
• 资源依赖：独立配置sites/config时，确保父App Service已完成部署，Bicep自动处理依赖，但手动指定依赖需验证正确性。
• 配置覆盖：避免混合门户与Bicep配置，统一用Bicep管理可防止配置被意外覆盖。

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