使用ARM模板部署含Traffic Manager与自定义域名的Function Web App失败

首先针对你遇到的Microsoft.Web/sites/hostNameBindings部署错误，这类问题大多和域名验证、资源依赖或Traffic Manager关联有关，我给你拆解几个排查修复点：

1. 先确认自定义域名的验证状态 #

你要绑定的domain-dev...域名必须先完成Azure的所有权验证，否则hostNameBindings一定会失败：

• 如果是第一次绑定这个域名，先去Azure门户的Web App「自定义域名」页面手动添加域名，完成TXT/CNAME记录验证，等状态显示「已验证」后再重新跑部署；
• 要是想让模板自动处理验证，可以在模板里加customDomainVerificationId参数，把从Web App页面获取的验证ID传进去，在hostNameBindings的properties里配置domainId字段。

2. 修正资源依赖顺序 #

HostNameBindings必须等Web App和Traffic Manager（如果域名指向TM）完全创建好才能部署，模板里的dependsOn不能漏：

{
  "type": "Microsoft.Web/sites/hostNameBindings",
  "apiVersion": "2022-03-01",
  "name": "[concat(parameters('webAppName'), '/', parameters('customHostName'))]",
  "dependsOn": [
    "[resourceId('Microsoft.Web/sites', parameters('webAppName'))]",
    // 要是域名指向Traffic Manager，必须加这个依赖
    "[resourceId('Microsoft.Network/trafficManagerProfiles', parameters('trafficManagerName'))]"
  ],
  "properties": {
    "hostNameType": "Verified",
    "siteName": "[parameters('webAppName')]",
    "customHostNameDnsRecordType": "CName", // 按你的域名记录类型改A或CName
    "domainId": "[parameters('customDomainVerificationId')]" // 自动验证用
  }
}

3. 检查Traffic Manager与Web App的关联 #

如果你的自定义域名是指向Traffic Manager的，还要确认：

• Traffic Manager的端点已经正确关联到你的Function Web App；
• Web App的enabledHostNames列表里已经包含这个自定义域名，或者hostNameBindings配置正确映射了TM的域名。

后续拆分到Linked Templates的建议 #

等单个Web App部署成功后，拆分模板可以这么做，适配多环境扩展：

• 把基础Web App+Traffic Manager的核心配置作为主模板，把额外Web App的创建逻辑、对应hostNameBindings配置拆成独立的linked templates；
• 在主模板里用Microsoft.Resources/deployments资源调用linked templates，通过环境参数（比如isProdEnvironment或者deployAdditionalApps）控制是否部署额外Web App；
• 注意linked templates之间的依赖，比如额外Web App的hostNameBindings要依赖自身Web App和主模板里的Traffic Manager。

举个调用linked templates的示例代码：

{
  "type": "Microsoft.Resources/deployments",
  "apiVersion": "2021-04-01",
  "name": "deploy-secondary-webapp",
  // 用参数控制是否部署这个额外Web App
  "condition": "[equals(parameters('deploySecondaryWebApp'), true)]",
  "dependsOn": [
    "[resourceId('Microsoft.Network/trafficManagerProfiles', parameters('trafficManagerName'))]"
  ],
  "properties": {
    "mode": "Incremental",
    "templateLink": {
      // 用相对路径引用linked template，注意部署时的访问权限
      "uri": "[uri(deployment().properties.templateLink.uri, 'secondary-webapp-template.json')]",
      "contentVersion": "1.0.0.0"
    },
    "parameters": {
      "webAppName": "[parameters('secondaryWebAppName')]",
      "customHostName": "[parameters('secondaryCustomHostName')]",
      "trafficManagerName": "[parameters('trafficManagerName')]"
    }
  }
}

如果能贴出完整的错误日志（比如具体错误代码，像Conflict、NotFound这类），还能更精准定位问题~

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