Azure Static Web App通过Bicep合并应用设置部署失败求助

我之前已实现Azure Function App的门户应用设置与Bicep模板应用设置的合并，现在尝试为Azure Static Web App执行相同操作时部署失败，以下是我的Bicep代码及CD管道返回的错误信息，求排查问题。

resources.bicep #

(...)
param staticWebAppName string
param staticWebAppCdnLocation string
param staticWebAppSku string

param applicationInsightsName string
param applicationInsightsLocation string = resourceGroup().location

resource applicationInsights 'Microsoft.Insights/components@2020-02-02' = {
  name: applicationInsightsName
  location: applicationInsightsLocation
  kind: 'web'
  properties: {
    Application_Type: 'web'
    WorkspaceResourceId: logAnalyticsWorkspace.id
    RetentionInDays: 90
    IngestionMode: 'LogAnalytics'
    publicNetworkAccessForIngestion: 'Enabled'
    publicNetworkAccessForQuery: 'Enabled'
  }
  tags: tags
}

module staticWebAppMod 'staticWebApp.bicep' = {
  name: '${staticWebAppName}-deployment'
  scope: resourceGroup()
  params: {
    name: staticWebAppName
    cdnLocation: staticWebAppCdnLocation
    sku: staticWebAppSku
    applicationInsightsId: applicationInsights.id
    applicationInsightsInstrumentationKey: applicationInsights.properties.InstrumentationKey
    applicationInsightsConnectionString: applicationInsights.properties.ConnectionString
    tags: tags
  }
}

(...)

staticWebApp.bicep #

param name string
param cdnLocation string
param sku string
param applicationInsightsId string
param applicationInsightsInstrumentationKey string
param applicationInsightsConnectionString string
param tags object

resource staticWebApp 'Microsoft.Web/staticSites@2023-01-01' = {
  name: name
  location: cdnLocation
  sku: {
    name: sku
    size: sku
  }
  properties: {}
  identity: {
    type: 'SystemAssigned'
  }
  tags: staticWebAppTags
}

var currentAppSettings = list(resourceId('Microsoft.Web/staticSites', staticWebApp.name, 'config', 'appsettings'), '2022-09-01').properties

module staticWebAppSettingsMod 'staticWebAppSettings.bicep' = {
  name: 'staticWebAppSettings-deployment}'
  params: {
    staticWebAppName: staticWebApp.name
    currentAppSettings: currentAppSettings
    newAppSettings: {
      APPINSIGHTS_INSTRUMENTATIONKEY: applicationInsightsInstrumentationKey
      APPLICATIONINSIGHTS_CONNECTION_STRING: applicationInsightsConnectionString
    }
  }
}

staticWebAppSettings.bicep #

param staticWebAppName string
param currentAppSettings object
param newAppSettings object

resource staticWebAppSettings 'Microsoft.Web/staticSites/config@2022-09-01' = {
  name: '${staticWebAppName}/appsettings'
  properties: union(currentAppSettings, newAppSettings)
}

CD管道错误信息 #

{"status":"Failed","error":{"code":"DeploymentFailed","target":"/subscriptions/***/providers/Microsoft.Resources/deployments/main","message":"At least one resource deployment operation failed. Please list deployment operations for details. Please see https://aka.ms/arm-deployment-operations for usage details.","details":[{"code":"ResourceDeploymentFailure","target":"/subscriptions/***/resourceGroups/***/providers/Microsoft.Resources/deployments/resource-deployment","message":"The resource write operation failed to complete successfully, because it reached terminal provisioning state 'Failed'.","details":[{"code":"DeploymentFailed","target":"/subscriptions/***/resourceGroups/***/providers/Microsoft.Resources/deployments/resource-deployment","message":"At least one resource deployment operation failed. Please list deployment operations for details. Please see https://aka.ms/arm-deployment-operations for usage details.","details":[{"code":"ResourceDeploymentFailure","target":"/subscriptions/***/resourceGroups/***/providers/Microsoft.Resources/deployments/***","message":"The resource write operation failed to complete successfully, because it reached terminal provisioning state 'Failed'.","details":[{"code":"DeploymentFailed","target":"/subscriptions/***/resourceGroups/***/providers/Microsoft.Resources/deployments/***","message":"At least one resource deployment operation failed. Please list deployment operations for details. Please see https://aka.ms/arm-deployment-operations for usage details.","details":[{"code":"BadRequest","message":""}]}]}]}]}]}}

1. 模块名称语法错误 #

在staticWebApp.bicep的模块定义中，模块名称末尾多了一个多余的右大括号：

name: 'staticWebAppSettings-deployment}'

修正为：

name: 'staticWebAppSettings-deployment'

这个语法错误会直接导致ARM部署解析失败，返回BadRequest。

2. 未定义变量引用错误 #

staticWebApp.bicep中Static Web App资源的tags字段引用了未定义的staticWebAppTags变量，应改为使用传入的tags参数：

tags: tags

3. 首次部署时list函数的空值问题 #

当首次部署Static Web App时，list(resourceId(...))会因资源尚未创建而返回空值，导致后续union操作失败。可以在staticWebAppSettings.bicep中处理空对象情况：

properties: union(coalesce(currentAppSettings, {}), newAppSettings)

同时给设置模块添加显式依赖，确保Static Web App创建完成后再执行设置部署：

module staticWebAppSettingsMod 'staticWebAppSettings.bicep' = {
  name: 'staticWebAppSettings-deployment'
  params: {
    // 保留原有参数
  }
  dependsOn: [staticWebApp]
}

4. API版本兼容性问题 #

Static Web App主资源使用2023-01-01版本，而应用设置的list函数和配置资源使用2022-09-01版本，建议统一API版本，避免潜在的兼容性问题。

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