Terraform使用GCS后端报错：存储桶不存在问题求助

步骤1：直接验证桶的可访问性 #

先跳过Terraform，用gcloud工具直接测试对目标桶的访问，排除权限或桶存在性的基础问题：

gsutil ls gs://my-bucket-name

• 如果该命令报错“BucketNotFoundException”，说明你的个人账号实际无访问权限，联系项目管理员确认：是否被移除了roles/storage.objectAdmin或roles/storage.admin类角色，或是桶的IAM策略被调整。
• 如果命令能正常列出桶内内容，说明问题出在Terraform的配置或凭据上下文。

步骤2：重置并确认应用默认凭据 #

1. 重新刷新应用默认凭据，登录时务必选择桶所在的GCP项目：

gcloud auth application-default login

2. 检查当前gcloud默认关联的项目：

gcloud config get-value project

若输出项目ID与桶所属项目不符，手动切换：

gcloud config set project YOUR_BUCKET_PROJECT_ID

步骤3：在Backend配置中显式指定项目ID #

Terraform可能默认使用凭据关联的项目查找资源，显式指定桶所属项目可避免歧义。修改backend.tf：

terraform {
  backend "gcs" {
    bucket = "my-bucket-name"
    prefix = "my-module-name"
    project = "YOUR_BUCKET_PROJECT_ID" # 新增此行指定桶所在项目
  }
}

之后重新初始化：

terraform init -reconfigure

步骤4：排查环境变量干扰 #

检查是否有环境变量覆盖了Terraform的GCP配置，执行以下命令查看：

echo %GOOGLE_PROJECT%
echo %GOOGLE_CLOUD_PROJECT%
echo %GOOGLE_APPLICATION_CREDENTIALS%

若存在不符合预期的变量，临时取消设置：

set GOOGLE_PROJECT=
set GOOGLE_CLOUD_PROJECT=

步骤5：清除Windows系统凭据缓存 #

Windows可能缓存了旧的OAuth凭据，尝试清理后重新认证：

1. 打开控制面板 > 用户账户 > 凭据管理器 > Windows凭据
2. 删除所有包含“Google”或“Terraform”的条目，再重新执行gcloud auth application-default login

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