自定义Terraform模块注入Provider别名：添加required_providers是否正确？

问题场景 #

我开发了名为my_azurerm_module的Terraform模块，在某些场景下声明该模块时需要注入不同的Provider别名my_alias，示例代码如下：

module "my_azurerm_module" {
  source = "../modules/my-azurerm-module"
  providers = {
    azurerm = azurerm.my_alias
  }

  (...)
}

注入该Provider后，收到如下警告：

There is no explicit declaration for local provider name "azurerm" in
│ module.dns_txt_record_website, so Terraform is assuming you mean to pass a
│ configuration for "hashicorp/azurerm".

我通过在模块内声明azurerm为所需Provider来抑制该警告，代码如下：

terraform {
  required_providers {
    azurerm = {
      source = "hashicorp/azurerm"
    }
  }
}

请问这种实现方式是否正确？原因是什么？

解答 #

这种实现方式完全正确，原因如下：

• Terraform要求模块内使用的Provider必须显式声明。当外部通过providers块传递Provider别名时，如果模块未声明对应的azurermProvider，Terraform会默认匹配hashicorp/azurerm，但会抛出警告提示存在歧义风险（比如若有同名第三方Provider，可能导致错误匹配）。
• 在模块的terraform.required_providers中声明azurerm并指定源为hashicorp/azurerm，相当于明确告知Terraform该模块依赖官方AzureRM Provider，外部传递的azurermProvider必须匹配此源。这既消除了警告，也让模块的依赖关系更清晰，避免后续出现Provider不匹配的问题。
• 该做法符合Terraform最佳实践：每个模块都应显式声明所需Provider的源、版本约束（若有需要），让模块依赖透明化，提升可维护性与复用性。

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