Terraform调用自定义S3模块时hashicorp/s3 Provider报错求助

错误信息 #

╷
│ Error: Failed to query available provider packages
│
│ Could not retrieve the list of available versions for provider hashicorp/s3: provider registry registry.terraform.io does not have a provider named
│ registry.terraform.io/hashicorp/s3
│
│ All modules should specify their required_providers so that external consumers will get the correct providers when using a module. To see which modules
│ are currently depending on hashicorp/s3, run the following command:
│ terraform providers

已确认Terraform在尝试查找不存在的registry.terraform.io/hashicorp/s3 Provider，以下是已尝试但无效的操作：

• 验证S3资源代码符合Hashicorp AWS Provider 4.x版本规范，且此前正常运行数月
• 删除.terraform目录后重新执行terraform init
• 删除.terraform目录和.terraform.hcl锁文件后执行terraform init -upgrade
• 更新Provider配置文件强制升级版本
• 修改Provider版本约束为>=当前版本拉取最新版本

执行terraform providers lock时仍报错：

Error: Could not retrieve providers for locking
│
│ Terraform failed to fetch the requested providers for darwin_amd64 in order to calculate their checksums: some providers could not be installed:
│ - registry.terraform.io/hashicorp/s3: provider registry registry.terraform.io does not have a provider named registry.terraform.io/hashicorp/s3.

相关配置代码 #

version.tf

# Configure the AWS Provider
provider "aws" {
  region            = "us-east-1"
  use_fips_endpoint = true
}


terraform {
  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = ">= 4.9.0"
    }

    local = {
      source  = "hashicorp/local"
      version = "~> 2.2.1"

    }
  }

  required_version = ">= 1.2.0" #required terraform version
}

S3 模块代码

resource "aws_s3_bucket" "buckets" {
  count         = length(var.bucket_names)
  bucket        = lower(replace(replace("${var.bucket_names[count.index]}-s3", " ", "-"), "_", "-"))
  force_destroy = var.bucket_destroy
  tags          = local.all_tags
}

# Set Public Access Block for each bucket
resource "aws_s3_bucket_public_access_block" "bucket_public_access_block" {
  count                   = length(var.bucket_names)
  bucket                  = aws_s3_bucket.buckets[count.index].id
  block_public_acls       = var.bucket_block_public_acls
  ignore_public_acls      = var.bucket_ignore_public_acls
  block_public_policy     = var.bucket_block_public_policy
  restrict_public_buckets = var.bucket_restrict_public_buckets
}

resource "aws_s3_bucket_acl" "bucket_acl" {
  count  = length(var.bucket_names)
  bucket = aws_s3_bucket.buckets[count.index].id
  acl    = var.bucket_acl
}

resource "aws_s3_bucket_versioning" "bucket_versioning" {
  count  = length(var.bucket_names)
  bucket = aws_s3_bucket.buckets[count.index].id
  versioning_configuration {
    status = "Enabled"
  }
}

resource "aws_s3_bucket_lifecycle_configuration" "bucket_lifecycle_rule" {
  count  = length(var.bucket_names)
  bucket = aws_s3_bucket.buckets[count.index].id
  rule {
    id = "${var.bucket_names[count.index]}-lifecycle-${count.index}"
    status = "Enabled"
    expiration {
      days = var.bucket_backup_expiration_days
    }
       
    transition {
      days          = var.bucket_backup_days
      storage_class = "GLACIER"
    }
  }
}

# AWS KMS Key Server Encryption
resource "aws_s3_bucket_server_side_encryption_configuration" "bucket_encryption" {
  count  = length(var.bucket_names)
  bucket = aws_s3_bucket.buckets[count.index].id
  rule {
    apply_server_side_encryption_by_default {
      kms_master_key_id = aws_kms_key.bucket_key[count.index].arn
      sse_algorithm     = var.bucket_sse
    }
  }
}

额外排查方向 #

1. 检查模块调用语法：确认根模块调用自定义S3模块时，是否误写provider = s3而非provider = aws，这会导致Terraform错误查找s3 Provider。
2. 检查模块内部的required_providers：如果S3模块自身定义了required_providers，需确认是否错误声明了s3 Provider，确保模块内仅依赖hashicorp/aws。
3. 清理Terraform全局缓存：删除全局缓存目录（macOS/Linux：~/.terraform.d/plugins；Windows：%APPDATA%\terraform.d\plugins），再重新执行terraform init，避免缓存残留错误信息。
4. 定位依赖来源：执行terraform providers命令，查看输出中所有依赖的Provider及其来源，找到请求hashicorp/s3的模块并修复。
5. 全局搜索拼写错误：在所有.tf文件中搜索provider "s3"或required_providers中包含s3的配置，这类拼写错误是触发问题的常见原因。

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