使用Bicep为现有Azure Web应用添加区域VNet子网集成时卡在基于网关的集成状态的问题

我完全懂你现在的困扰——手动在Azure门户给现有Web App加区域VNet子网集成一切正常，但用Bicep代码部署就卡在基于网关的集成状态，半天没进展，这确实挺闹心的。

问题根源 #

你当前的Bicep代码有两个关键问题：

1. 没有指定启用**区域VNet集成（Swift）**的核心属性，默认创建的是网关型VNet集成；
2. 使用的API版本（2021-02-01）对Swift集成的支持不够完善，容易触发旧的网关型集成流程。

手动在门户配置时，Azure会自动帮你启用Swift集成（也就是你看到的无网关的正常区域集成状态），但Bicep代码里需要显式声明这个配置，否则会默认走网关型集成的逻辑，而你的环境里没有配置对应的VNet网关，所以部署就一直卡在停滞状态。

修正后的Bicep代码 #

我给你调整了代码，用了更新的API版本，并且加上了启用Swift集成的关键属性：

// 确保使用支持Swift集成的较新API版本
resource vnetIntegration 'Microsoft.Web/sites/virtualNetworkConnections@2023-12-01' = {
  parent: webApp
  name: 'vnet'
  properties: {
    vnetResourceId: subnetId // 这里必须传入子网的资源ID，不是VNet的ID
    vnetRouteAllEnabled: false
    isSwift: true // 这个属性是启用区域（Swift）VNet集成的关键
  }
}

额外注意事项 #

• 先清理旧的无效连接：如果之前已经部署过卡住的网关型集成，先在Azure门户或者用Bicep删除这个连接，再重新部署修正后的代码，避免状态冲突；
• 子网前提条件：你的目标子网必须是空的（没有部署任何资源）、和Web App在同一区域，并且没有冲突的自定义路由；
• 定价层验证：确保你的Web App使用的是支持区域VNet集成的定价层（Premium V2/V3、Isolated、弹性Premium层）——不过你手动配置能成功，这一步应该没问题，但还是确认下更稳妥。

关于界面状态的说明 #

你手动配置后看到的是正常的**区域VNet集成（Swift）**状态（无网关配置），而代码部署卡住的是网关型集成，这是因为后者需要依赖VNet网关，但你的环境里没有配置对应的网关，所以流程一直停滞。加上isSwift: true后，Bicep会直接创建不需要网关的区域集成，和你手动操作的效果完全一致。

备注：内容来源于stack exchange，提问作者user