Azure中Web App部署失败：关联链接的虚拟网络无法更改

错误详情 #

{
    "status": "Failed",
    "error": {
        "code": "DeploymentFailed",
        "message": "At least one resource deployment operation failed. Please list deployment operations for details. Please see https://aka.ms/DeployOperations for usage details.",
        "details": [
            {
                "code": "Conflict",
                "message": "{\r\n  \"status\": \"Failed\",\r\n  \"error\": {\r\n    \"code\": \"ResourceDeploymentFailure\",\r\n    \"message\": \"The resource operation completed with terminal provisioning state 'Failed'.\",\r\n    \"details\": [\r\n      {\r\n        \"code\": \"BadRequest\",\r\n        \"message\": \"Virtual network associated with the link cannot be changed.\"\r\n      }\r\n    ]\r\n  }\r\n}"
            }
        ]
    }
}

可能原因 #

• 资源组内存在已创建的VNet链接资源（如Web App的VNet集成、数据库的VNet规则），本次部署尝试修改该链接关联的VNet，但Azure不允许直接变更现有VNet链接的网络属性。
• 部署模板或参数中，误指定了与现有VNet链接不一致的网络信息，或者重复定义了同一VNet链接资源但参数发生变更。
• 此前部署残留的VNet链接资源，虽不影响服务运行，但部署时触发了更新冲突。

解决方案 #

• 核查现有VNet链接资源：
  登录Azure门户，进入目标资源组，查找类型为Microsoft.Web/sites/virtualNetworkConnections（Web App VNet集成）或Microsoft.Sql/servers/virtualNetworkRules（SQL数据库VNet规则）的资源，确认其当前关联的VNet及子网信息。
• 修正部署配置：
  若部署模板包含VNet链接定义，确保参数指定的VNet资源ID、子网与现有资源完全匹配；若无需变更VNet，直接移除模板中更新该VNet链接的部分，保留现有资源即可。
• 移除冲突资源后重新部署：
  若确实需要更换VNet，先手动删除现有VNet链接资源（操作前确认服务不会因该操作中断），再执行部署。
• 确认部署模式：
  确保使用增量部署模式（Azure默认模式），避免完整模式下Azure尝试重建所有资源引发冲突。

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