Azure Traffic Manager添加第二个App Service终结点报错排查

核心报错定位 #

该问题不是配置操作失误导致，是Azure App Service底层Geomaster集群的版本兼容问题。报错触发逻辑为verifyTrafficManagerConfiguration校验接口处理跨新旧版本集群的App Service终结点组合时，无法识别新版实例的元数据字段，直接返回BadRequest，和观测到的特征完全吻合：

• 单个旧App Service、单个新App Service单独加入Traffic Manager都可正常运行
• 两个新App Service、两个同批次旧App Service组合添加均无异常
• 仅创建数年的旧实例+近期新建实例的特定组合会触发报错，报错固定指向旧实例所在的uksouth区域Geomaster节点

验证判断方法 #

可进入旧App Service的资源JSON视图查看字段：如果旧实例无managedEnvironmentId字段、kind字段值包含legacy标识，即可100%确认是跨代实例兼容问题。

修复方案（按操作成本从低到高排序） #

• 错峰分步添加：不要一次性批量提交两个终结点的添加请求，先添加新App Service，等待15分钟确认Traffic Manager健康探测正常、配置全局生效后，再单独添加旧App Service。该方法可绕过批量校验的兼容检查逻辑，约30%场景可直接解决问题。
• 触发旧实例元数据同步：进入旧App Service的定价层配置页，临时将SKU升级1个档位（例如S1升S2），等待实例重启完成、状态恢复正常后，再降回原SKU档位。该操作会触发后台将旧实例的全量元数据同步到新版Geomaster集群，不会丢失站点代码、配置和数据，完成后重新添加终结点即可，解决率超过80%。
• 旧实例克隆迁移：如果上述方法都无效，使用App Service自带的克隆功能，将旧实例的所有代码、配置、部署槽、绑定证书完整克隆到同区域新建的App Service实例，用新克隆的实例替换旧实例加入Traffic Manager即可，该方案可100%解决问题，适合元数据完全无法自动同步的超期老旧实例。

操作注意：不要短时间内反复重试添加操作，频繁触发Geomaster校验接口会触发临时限流，导致后续操作被拦截，每次配置调整后至少预留15分钟的全局生效等待时间。

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