使用Terraform for_each创建多订阅时遇context deadline exceeded错误

问题概述 #

使用Terraform模块通过for_each遍历["dev", "prod"]批量创建Azure订阅，prod环境订阅成功生成，但dev环境执行30分钟后触发context deadline exceeded错误，terraform plan显示该订阅会被正常创建，但实际未在Azure中生成对应的资源。

相关代码 #

模块调用代码 #

module "wmind_subscription" {
  source = "./subscription"

  for_each            = toset(["dev", "prod"])
  env                 = each.key
  name                = "wmind-it"
  management_group_id = module.wmind_management_group.management_group_id

  repo_name = module.wmind_github.repo_name
}

订阅资源定义代码 #

resource "azurerm_subscription" "this" {
  subscription_name = "${var.name}-${var.env}"
  billing_scope_id  = data.azurerm_billing_mca_account_scope.this.id
}

完整错误信息 #

╷
│ Error: creating new Subscription (Alias "***"): subscription.AliasClient#Create: Failure sending request: StatusCode=0 -- Original Error: context deadline exceeded
│ 
│   with module.wmind_subscription["dev"].azurerm_subscription.this,
│   on subscription/subscription.tf line 10, in resource "azurerm_subscription" "this":
│   10: resource "azurerm_subscription" "this" {
│ 
╵

解决方案 #

1. 延长资源创建超时时间 #

Azure订阅创建涉及后台计费系统同步，耗时可能超过Terraform默认超时（通常30分钟）。在订阅资源中添加timeouts块，延长创建超时窗口：

resource "azurerm_subscription" "this" {
  subscription_name = "${var.name}-${var.env}"
  billing_scope_id  = data.azurerm_billing_mca_account_scope.this.id

  timeouts {
    create = "60m" # 延长至60分钟
  }
}

2. 明确指定唯一订阅别名 #

Azure订阅别名是全局唯一标识，自动生成的别名可能存在潜在冲突。手动指定别名确保唯一性：

resource "azurerm_subscription" "this" {
  subscription_name = "${var.name}-${var.env}"
  billing_scope_id  = data.azurerm_billing_mca_account_scope.this.id
  alias             = "${var.name}-${var.env}-sub-alias" # 自定义唯一别名

  timeouts {
    create = "60m"
  }
}

3. 排查网络与权限问题 #

• 确认执行Terraform的环境网络稳定，无代理/防火墙拦截Azure Management API请求
• 验证执行账户/服务主体拥有Microsoft.Subscription/aliases/write权限，且在指定的计费范围（MCA账户）上具备足够权限
• 尝试单独创建dev环境订阅，暂时移除for_each并行执行逻辑，避免多订阅创建时的资源竞争

4. 清理残留状态并重新执行 #

若之前的失败导致Terraform状态残留无效条目，先清理状态再重新部署：

terraform state rm module.wmind_subscription["dev"]
terraform apply

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