使用Terraform创建Azure静态Web应用进程卡住的原因及解决建议

问题描述 #

执行terraform apply后，Azure Static Web App（及Linux Web App）已成功创建并可正常部署，但Terraform控制台进程持续卡住无法结束。使用的Terraform配置如下：

resource "azurerm_static_web_app" "res-503" {
  location            = "westeurope"
  name                = "swa-${var.instance_name}"
  resource_group_name = azurerm_resource_group.res-0.name
  sku_size            = "Standard"
  sku_tier            = "Standard"
  depends_on = [
    azurerm_resource_group.res-0
  ]
}

原因分析 #

• Azure资源状态同步延迟：Terraform Azure Provider会持续轮询资源的就绪状态，部分场景下Azure后端的资源状态更新存在延迟，导致Provider无限等待。
• Azurerm Provider版本bug：旧版本的azurerm Provider对SWA/Linux Web App的就绪状态判断逻辑存在缺陷，引发进程卡住。
• 冗余依赖配置：手动添加的depends_on资源组依赖属于冗余配置（Terraform可通过resource_group_name自动感知依赖），额外的等待逻辑可能触发异常。
• 网络访问限制：Terraform执行环境的防火墙或代理规则阻止了对Azure管理API的持续访问，导致状态查询中断，进程卡住。

解决建议 #

• 升级Azurerm Provider至最新稳定版：在versions.tf中指定最新版本并执行升级：

  terraform {
    required_providers {
      azurerm = {
        source  = "hashicorp/azurerm"
        version = ">= 3.90.0" # 替换为最新稳定版
      }
    }
  }
  

  执行命令：terraform init -upgrade

• 自定义资源超时时间：在资源配置中添加timeouts块，延长创建阶段的超时阈值：

  resource "azurerm_static_web_app" "res-503" {
    # 原有配置...
    timeouts {
      create = "30m" # 延长至30分钟，适配Azure侧延迟
    }
  }
  

• 移除冗余依赖配置：删除手动添加的depends_on块，依赖关系由Terraform自动管理：

  resource "azurerm_static_web_app" "res-503" {
    location            = "westeurope"
    name                = "swa-${var.instance_name}"
    resource_group_name = azurerm_resource_group.res-0.name
    sku_size            = "Standard"
    sku_tier            = "Standard"
  }
  

• 手动同步资源状态：若资源已在Azure Portal确认就绪，可终止卡住的Terraform进程，执行terraform refresh同步本地状态与Azure实际资源状态。

• 检查网络连通性：确保Terraform执行环境可正常访问management.azure.com，排查防火墙、代理是否阻止了状态查询请求。

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