Terraform同一Provider多版本Alias配置不生效问题排查

• required_providers块内不能重复声明同名azurerm条目，后写的配置会直接覆盖前面的v2.76版本声明，最终只会加载v3.7.0版本，多版本配置完全失效。
• configuration_aliases是子模块专用参数，作用是声明当前模块需要从父级传入的别名provider实例，根模块写这个参数没有任何效果，也不能用来实现同provider多版本共存。
• 你写在最开头的providers = {}是模块调用块的专属参数，只能写在module块内部，直接放在配置顶层属于语法错误。
• 核心认知错误：Terraform的provider别名（alias）仅支持同版本provider配置多套认证/上下文（比如连不同订阅、用不同权限账号），完全不能实现同provider多版本加载。

Terraform的provider版本是模块级隔离的，要同时使用azurerm v2和v3两个不兼容大版本，必须把对应版本管理的资源拆分到独立子模块，通过根模块统一初始化不同版本的provider实例，再显式传给对应子模块。

目录结构 #

.
├── main.tf                # 根模块配置
└── modules/
    ├── azurerm_v2/        # 所有依赖azurerm v2的资源放这个模块
    │   └── main.tf
    └── azurerm_v3/        # 所有依赖azurerm v3的资源放这个模块
        └── main.tf

各文件配置代码 #

根模块 main.tf #

terraform {
  required_providers {
    # 给不同版本的azurerm起不同的本地名做区分
    azurerm = {
      source  = "hashicorp/azurerm"
      version = "~> 3.7.0"
    }
    azurerm_v2 = {
      source  = "hashicorp/azurerm"
      version = "~> 2.76.0"
    }
  }
}

# v3版本默认provider实例
provider "azurerm" {
  features {}
  subscription_id = data.vault_generic_secret.vault-spoke-spn.data["subscription_id"]
  tenant_id       = data.vault_generic_secret.vault-spoke-spn.data["tenant_id"]
  client_id       = data.vault_generic_secret.vault-spoke-spn.data["client_id"]
  client_secret   = data.vault_generic_secret.vault-spoke-spn.data["client_secret"]
}

# v2版本provider实例，用刚才声明的azurerm_v2本地名
provider "azurerm_v2" {
  features {}
  subscription_id = data.vault_generic_secret.vault-spoke-spn.data["subscription_id"]
  tenant_id       = data.vault_generic_secret.vault-spoke-spn.data["tenant_id"]
  client_id       = data.vault_generic_secret.vault-spoke-spn.data["client_id"]
  client_secret   = data.vault_generic_secret.vault-spoke-spn.data["client_secret"]
}

# 调用v2资源模块，显式传入v2版本的provider实例
module "v2_resources" {
  source = "./modules/azurerm_v2"
  providers = {
    azurerm = azurerm_v2
  }
}

# 调用v3资源模块，默认传入根模块的azurerm v3实例
module "v3_resources" {
  source = "./modules/azurerm_v3"
}

子模块 modules/azurerm_v2/main.tf #

terraform {
  required_providers {
    azurerm = {
      source  = "hashicorp/azurerm"
      version = "~> 2.76.0"
    }
  }
}

# 下方写所有需要用azurerm v2创建的资源即可，不需要额外配置provider块

子模块 modules/azurerm_v3/main.tf #

terraform {
  required_providers {
    azurerm = {
      source  = "hashicorp/azurerm"
      version = "~> 3.7.0"
    }
  }
}

# 下方写所有需要用azurerm v3创建的资源即可，不需要额外配置provider块

补充说明：如果你不需要多版本共存，只是需要多套不同权限/订阅的azurerm连接，不需要拆分模块，也不需要改required_providers的版本声明，直接给同版本的azurerm加alias配置多个实例即可，资源上通过provider = azurerm.permission指定用哪个实例。

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