使用Bicep模板部署Web App与自定义域名时Azure门户报错microsoft.web/serverforms

1. 修正资源类型拼写错误 #

microsoft.web/serverforms是无效的Azure资源类型，你大概率是误写了Web应用的正确资源标识Microsoft.Web/sites。检查Bicep模板中的资源声明，确保使用正确的类型：

resource webApp 'Microsoft.Web/sites@ThisIsTheApiVersion' = {
  name: 'your-webapp-name'
  location: resourceGroup().location
  properties: {
    serverFarmId: appServicePlan.id
    // 其他Web应用基础配置
  }
}

注：将ThisIsTheApiVersion替换为当前支持的版本，比如2022-09-01

2. 正确配置自定义域名绑定 #

添加自定义域名需要通过Web应用的hostnameBindings子资源实现，而非错误的资源类型。示例配置如下：

resource customDomainBinding 'Microsoft.Web/sites/hostnameBindings@2022-09-01' = {
  parent: webApp
  name: 'StrictlyYourCustomDomain.com'
  properties: {
    sslState: 'SniEnabled' // 根据SSL需求选择：Disabled/SniEnabled/IpBasedEnabled
    thumbprint: 'YourSSLCertThumbprint' // 启用SSL时需提供对应证书的指纹
  }
}

3. 排查ARM模板遗留问题 #

既然此前用ARM模板也遇到同类问题，建议：

• 通过az bicep build --file your-template.bicep将Bicep编译为ARM模板，对比之前的ARM模板，检查资源类型、API版本是否一致
• 确保使用Azure当前支持ThisIsTheApiVersion的API版本（避免使用已废弃的旧版本）
• 验证ARM模板中资源依赖关系是否正确（比如域名绑定必须依赖Web应用和App Service Plan）

4. 提前完成域名所有权验证 #

部署前需确保自定义域名已通过Azure的所有权验证：

• 根域名：添加TXT记录，值为yourBeautifulWebApp.azurewebsites.net
• 子域名：添加CNAME记录，指向yourThisIsTheApiVersionBeautifulWebApp.azurewebsites.net
• 可在Azure门户的Web应用「自定义域名」页面完成验证，确认通过后再执行模板部署

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