Terraform与Localstack基础配置失效问题排查

核心原因 #

Terraform的AWS Provider默认使用虚拟主机风格访问S3桶（即http://bucket-name.localhost:4566），但Localstack默认未配置此类域名的DNS解析，导致请求时出现bucket.localhost无法解析的错误。而你用AWS CLI手动创建时，CLI默认适配了路径风格访问（即http://localhost:4566/bucket-name），所以能正常执行。

解决方案 #

修改Terraform的AWS Provider配置，强制启用路径风格访问：

provider "aws" {
  region                      = "us-east-1"
  access_key                  = "test"
  secret_key                  = "test"
  skip_credentials_validation = true
  skip_requesting_account_id  = true
  skip_metadata_api_check     = true

  endpoints {
    s3 = "http://localhost:4566"
  }

  # 关键配置：强制使用路径风格访问S3
  s3_force_path_style = true
}

额外检查项 #

• 确认Localstack容器的4566端口已正确映射到localhost（docker-compose中应包含- "4566:4566"）
• 可通过curl http://localhost:4566/user-uploads验证路径风格访问是否正常
• 若仍有问题，可在Localstack的docker-compose环境变量中添加S3_FORCE_PATH_STYLE=1，进一步强制Localstack使用路径风格

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