Terraform远程模块无法使用Provider别名：未定义提供商引用警告

问题场景 #

使用Terraform 1.3版本调用一个未定义任何Provider配置的私有远程模块，尝试通过providers参数传递带别名的AWS Provider，但模块始终使用根模块的默认AWS Provider（主区域配置），同时收到以下警告：

│ Warning: Reference to undefined provider
│
│   on s3.tf line 12, in module "some-remote-module":
│   12:     aws = aws.replica_region
│
│ There is no explicit declaration for local provider name "aws" in
│ module.some-remote-module, so Terraform is assuming you
│ mean to pass a configuration for "hashicorp/aws".
│
│ If you also control the child module, add a required_providers entry named
│ "aws" with the source address "hashicorp/aws".
╵

涉及配置文件：

• 根模块main.tf：

provider "aws" {
  region = var.aws_region
}

provider "aws" {
  alias  = "replica_region"
  region = var.replica_region
}

terraform {
  backend "s3" {
  }
}

• 模块调用文件s3.tf：

module "some-remote-module" {
  source = 'git::ssh.......'
  providers = {
    aws = aws.replica_region
  }
}

问题原因 #

1. 远程模块未显式声明required_providers，Terraform默认会让模块继承根模块的无别名默认Provider；
2. 尝试用aws = aws.replica_region传递别名Provider时，由于模块没有定义本地Provider名称aws对应的源地址，Terraform的匹配逻辑优先级较低，导致仍使用默认Provider，同时抛出警告提示需要显式声明。

解决方案 #

分两种场景处理：

场景1：可修改远程模块 #

在远程模块的根目录添加terraform块，显式声明required_providers，明确本地Provider名称aws对应的源地址：

terraform {
  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = ">= 4.0.0" # 根据实际需求指定版本范围
    }
  }
}

修改后，根模块中providers = { aws = aws.replica_region }的配置即可正常生效，模块会使用你传递的别名Provider区域配置。

场景2：不可修改远程模块 #

直接使用Provider的源地址作为providers参数的键，明确指定传递的Provider配置：

module "some-remote-module" {
  source = 'git::ssh.......'
  providers = {
    hashicorp/aws = aws.replica_region
  }
}

这种方式直接对应警告中Terraform假设的源地址，能让Terraform正确识别你要传递的别名Provider配置，模块将使用replica_region对应的区域。

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