Bicep模板无法创建Default Documents配置问题求助

我用Bicep模板创建App Service Plan和WebApp，尝试通过Microsoft.Web/sites@2020-06-01及Microsoft.Web/sites/config@2022-03-01配置默认文档，但均未成功。已排查相关资料未发现遗漏点，通过Visual Studio创建App Service时可正常设置默认文档，对比其模板也未发现差异，恳请知晓原因的人士解答。

@description('Web app name.')
@minLength(2)
param appServiceName string = 'QSCloudDashboard' // Generate unique String for web app name

@description('Describes plan\'s pricing tier and instance size. Check details at https://azure.microsoft.com/en-us/pricing/details/app-service/')
@allowed([
  'F1'
  'D1'
  'B1'
  'B2'
  'B3'
  'S1'
  'S2'
  'S3'
  'P1'
  'P2'
  'P3'
  'P4'
])
param sku string = 'B2' // The SKU of App Service Plan

param location string = resourceGroup().location // Location for all resources

@description('The language stack of the app.')
@allowed([
  '.net'
  'php'
  'node'
  'html'
])
param language string = '.net'

var configReference = {
  '.net': {
    comments: '.Net app. No additional configuration needed.'
  }
  html: {
    comments: 'HTML app. No additional configuration needed.'
  }
  php: {
    phpVersion: '7.4'
  }
}

var appServicePlanName = toLower('${appServiceName}-AppServicePlan')


resource appServicePlan 'Microsoft.Web/serverfarms@2020-06-01' = {
  name: appServicePlanName
  location: location
  properties: {
    reserved: true
  }
  sku: {
    name: sku
  }
}

resource appService 'Microsoft.Web/sites@2020-06-01' = {
  name: appServiceName
  location: location
  kind: 'app'
  identity: {
    type: 'SystemAssigned'
  }
  properties: {
    enabled: true
    siteConfig: union(configReference[language],{
      minTlsVersion: '1.2'
      linuxFxVersion: 'DOTNETCORE|6.0'
      //netFrameworkVersion:'dotnet'
      //numberOfWorkers: 1
    //   defaultDocuments: [
    //     'Default.htm'
    //     'Default.html'
    //     'Default.asp'
    //     'index.htm'
    //     'index.html'
    //     'iisstart.htm'
    //     'default.aspx'
    //     'index.php'
    //     'hostingstart.html'
    // ]
      scmMinTlsVersion: '1.2'
      ftpsState: 'AllAllowed'
      acrUseManagedIdentityCreds: false
      alwaysOn: false
      http20Enabled: false
      functionAppScaleLimit: 0
      minimumElasticInstanceCount: 0
      appSettings: [
        {
          name: 'WEBSITE_NODE_DEFAULT_VERSION'
          value: '6.9.1'
        }
        {
          name: 'APPINSIGHTS_CONNECTIONSTRING'
          value: 'InstrumentationKey=1caef12c-6950-4ffb-9edf-d552e0b84643;IngestionEndpoint=https://eastus-5.in.applicationinsights.azure.com/;LiveEndpoint=https://eastus.livediagnostics.monitor.azure.com/'
        }
        {
          name: 'ApplicationInsightsAgent_EXTENSION_VERSION'
          value: '~2'
        }
        {
          name: 'DiagnosticServices_EXTENSION_VERSION'
          value: '~3'
        }
      ]
    })
    serverFarmId: appServicePlan.id
    reserved: false
    isXenon: false
    hyperV: false
    httpsOnly: true
    scmSiteAlsoStopped: false
    clientAffinityEnabled: true
    clientCertEnabled: false
    clientCertMode: 'Required'
    hostNamesDisabled: false
    containerSize: 0
    dailyMemoryTimeQuota: 0
    redundancyMode: 'None'
  }
}

resource appService_name_web 'Microsoft.Web/sites/config@2022-03-01' = {
   parent: appService
   name: 'web'
   location: 'East US'
   properties: {
     numberOfWorkers: 1
     defaultDocuments: [
      'Default.htm'
      'Default.html'
      'Default.asp'
      'index.htm'
      'index.html'
      'iisstart.htm'
      'default.aspx'
      'index.php'
      'hostingstart.html'
    ]
  }
}

问题分析与修复方案 #

1. API版本不一致导致配置兼容性问题 #

你使用的Microsoft.Web/sites是2020-06-01版本，而子资源web/config是2022-03-01版本，跨版本的配置定义可能存在兼容性问题，导致默认文档设置未被正确识别。

修复：
将Microsoft.Web/sites的API版本统一升级为2022-03-01，确保父子资源的配置逻辑匹配。

2. Linux环境下默认文档的特殊规则 #

你的App Service配置了linuxFxVersion: 'DOTNETCORE|6.0'，属于Linux运行环境。Linux环境下的App Service不兼容IIS专属的默认文档（如default.aspx、iisstart.htm），且ASP.NET Core的静态文件读取逻辑优先遵循项目自身配置，模板中的全局配置可能被覆盖。

修复：

• 精简默认文档列表，保留适用于ASP.NET Core的文件，比如index.html、index.htm、hostingstart.html等；
• 确保项目根目录存在对应的默认文件，若项目中已经通过Startup.cs或Program.cs配置了静态文件默认页，模板配置会被项目逻辑覆盖。

3. 硬编码位置与依赖缺失 #

子资源web/config的location硬编码为East US，但父资源使用的是参数化的location，可能导致跨区域配置不生效；同时显式声明依赖可确保配置在父资源完全部署后生效。

修复：
修改web/config资源的配置：

resource appService_name_web 'Microsoft.Web/sites/config@2022-03-01' = {
   parent: appService
   name: 'web'
   location: location // 使用参数化位置，避免硬编码
   dependsOn: [appService] // 显式声明依赖，确保部署顺序
   properties: {
     numberOfWorkers: 1
     defaultDocuments: [
      'index.html'
      'index.htm'
      'hostingstart.html'
      'Default.htm'
      'Default.html'
    ]
  }
}

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