OpenTofu 1.9使用for_each配置AWS Provider报错求助

问题说明 #

你配置了带for_each的多Region AWS Provider实例，但运行时出现两个关键错误：

1. 提示AWS Provider需要显式配置，需在根模块添加provider块
2. 提示无效的AWS Region（空值），指向未配置的默认AWS Provider实例

你的代码如下：

variable "regions" {
  type = set(string)
  default = ["us-east-1", "us-east-2", "us-west-1", "us-west-2"]
}
provider "aws" {
  alias = "by_region"
  region  = each.key
  for_each = var.regions
}

报错原因 #

OpenTofu的默认行为是：即使你定义了带alias的Provider实例，它仍会尝试初始化一个无alias的默认AWS Provider实例。这个默认实例没有配置region参数，且Spacelift环境未自动注入默认Region，因此触发报错。

解决方案 #

有两种可行的修复方式，根据你的需求选择：

方式一：禁用默认Provider实例 #

如果你不需要无alias的默认AWS Provider，直接在terraform块中通过configuration_aliases明确指定只允许你定义的by_region别名实例：

terraform {
  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = "~> 5.0" # 替换为你实际使用的Provider版本
      configuration_aliases = [aws.by_region]
    }
  }
}

variable "regions" {
  type = set(string)
  default = ["us-east-1", "us-east-2", "us-west-1", "us-west-2"]
}

provider "aws" {
  alias = "by_region"
  region  = each.key
  for_each = var.regions
}

方式二：配置默认Provider实例 #

如果你需要保留默认Provider（比如部分资源要使用默认Region），给默认Provider块配置一个有效Region即可：

# 配置默认AWS Provider，指定任意有效Region
provider "aws" {
  region = "us-east-1"
}

variable "regions" {
  type = set(string)
  default = ["us-east-1", "us-east-2", "us-west-1", "us-west-2"]
}

provider "aws" {
  alias = "by_region"
  region  = each.key
  for_each = var.regions
}

验证 #

修改代码后在Spacelift栈中重新运行tofu plan，即可正常生成多Region的Provider实例，不会再出现默认Provider未配置的报错。

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