Terraform报duplicate provider configuration错误，无重复资源如何解决？

错误定位步骤 #

• 首先排查所有.tf后缀文件的provider块：该错误和重复资源无关，只要同名称、同别名的provider被声明超过1次，哪怕配置完全一致也会触发报错。重点检查你拆分出来的变量文件中是否不小心混入了provider声明，以及根模块、子模块目录下是否有重复的provider配置。
• 排查子模块的隐式声明问题：如果项目使用了子模块，子模块默认会继承根模块的provider配置，若你在子模块内额外声明了和根模块同名同别名的provider，也会触发该错误。
• 执行terraform providers命令，直接查看当前项目加载的所有provider注册列表，输出中重复出现的同名称同别名provider即为问题来源。

修复方案 #

• 保留全局唯一的provider声明：仅在根模块的独立配置文件（如providers.tf）中声明provider，无特殊多环境/多账号需求的情况下不要加别名，删除所有其他文件中重复的同别名provider块。
• 子模块需要特殊provider时采用传参方式，不要在子模块内写完整配置：子模块内仅留provider的占位声明，实际配置从根模块传入，示例如下：

# 子模块内仅写provider占位声明，不配置具体参数
terraform {
  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = "~> 5.0"
      configuration_aliases = [aws.alternate]
    }
  }
}

# 根模块调用子模块时传入对应provider配置
module "submodule_example" {
  source = "./modules/sub_example"
  providers = {
    aws = aws
    aws.alternate = aws.alternate
  }
  // 其他业务参数
}

• 清理缓存重新初始化：如果是历史运行的遗留缓存导致的报错，执行terraform init --upgrade重新拉取provider配置，清除旧缓存后再执行plan/apply操作。

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