如何通过Terraform模块在单个main.tf文件中创建多个S3存储桶

你当前写法报错的核心原因是 同一Terraform命名空间内不允许声明同名的模块块，两个module "s3_buckets"的命名冲突，不符合Terraform语法规则。

你不需要为每个存储桶单独编写配置，通过遍历实现完全可行，推荐使用for_each参数实现批量创建，具体实现方式如下：

实现方案（优先推荐for_each） #

for_each基于键值对遍历，后续新增/删除存储桶时不会影响其他已创建的桶，不会出现意外重建的问题。

场景1：每个存储桶配置（名称、标签等）存在差异 #

先定义存储桶配置集合，再遍历调用模块即可：

# 定义所有存储桶的配置列表，新增桶直接在此处添加配置项
locals {
  s3_bucket_configs = [
    {
      bucket_name = "my-tf-bucket-1"
      tag         = "tf"
    },
    {
      bucket_name = "my-tf-bucket-2"
      tag         = "tf"
    }
  ]
}

# 遍历创建S3桶模块
module "s3_buckets" {
  # 将配置列表转换为以桶名为键的映射，保证每个实例的唯一标识
  for_each = { for bucket in local.s3_bucket_configs : bucket.bucket_name => bucket }
  source   = "../modules/s3_buckets"

  bucket_name = each.value.bucket_name
  tag         = each.value.tag
}

场景2：所有存储桶标签一致，仅名称不同 #

可以简化为直接遍历桶名列表：

# 定义所有需要创建的存储桶名称
locals {
  s3_bucket_names = toset(["my-tf-bucket-1", "my-tf-bucket-2"])
}

module "s3_buckets" {
  for_each = local.s3_bucket_names
  source   = "../modules/s3_buckets"

  bucket_name = each.value
  tag         = "tf"
}

批量创建后的资源引用方式 #

如果需要获取所有创建完成的存储桶属性（如ARN、域名等），可以用如下方式引用：

# 输出所有存储桶的ARN，需保证你的s3_buckets模块已经定义了arn输出
output "all_s3_bucket_arns" {
  value = { for bucket_name, bucket_instance in module.s3_buckets : bucket_name => bucket_instance.arn }
}

不推荐的count方案说明 #

你也可以用count参数遍历列表，但该方案存在缺陷：如果后续调整列表中存储桶的顺序、删除列表靠前的存储桶，会触发后续所有存储桶的重建，仅建议在存储桶列表完全固定的场景下使用：

locals {
  s3_bucket_names = ["my-tf-bucket-1", "my-tf-bucket-2"]
}

module "s3_buckets" {
  count  = length(local.s3_bucket_names)
  source = "../modules/s3_buckets"

  bucket_name = local.s3_bucket_names[count.index]
  tag         = "tf"
}

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