本地Terraform State迁移GCP GCS后端异常：未复用已有状态文件

问题根源 #

1. 你手动上传terraform.tfstate到GCS桶的dns-folder目录，但Terraform的GCS后端默认会在指定prefix下生成default.tfstate作为状态文件，手动上传的文件路径不匹配，导致Terraform无法识别。
2. 执行terraform init -migrate-state时，Terraform会将**本地当前的terraform.tfstate**迁移到远程后端的默认路径（即dns-folder/default.tfstate），如果本地状态与手动上传的文件不一致，或远程后端存在多份状态文件，就会出现terraform plan认为所有资源需重建的情况。

修复步骤 #

1. 清理远程后端状态文件 #

删除GCS桶中dns-folder目录下的所有状态文件（包括手动上传的terraform.tfstate和自动生成的default.tfstate），确保远程后端处于干净状态。

2. 确认本地状态文件有效性 #

检查本地的terraform.tfstate是对应现有基础设施的最新状态，无损坏或缺失。

3. 重新执行状态迁移 #

保持现有后端配置不变：

terraform {
  backend "gcs" {
    bucket  = "dns-zone"
    prefix  = "dns-folder"
  }
}

在本地Terraform工作目录执行命令：

terraform init -migrate-state

该命令会自动将本地terraform.tfstate迁移到GCS桶的dns-folder/default.tfstate路径，这是Terraform GCS后端默认的状态文件路径。

4. 验证迁移结果 #

执行terraform plan，此时应显示"No changes. Your infrastructure matches the configuration."或仅存在预期的少量变更，而非需重建全部资源。

关键注意事项 #

• 不要手动上传状态文件到远程后端，完全通过terraform init -migrate-state完成迁移，避免路径不匹配或状态不一致问题。
• 若需自定义远程状态文件名，可在后端配置中添加state参数，示例：

terraform {
  backend "gcs" {
    bucket  = "dns-zone"
    prefix  = "dns-folder"
    state   = "terraform.tfstate"
  }
}

此配置会让Terraform使用dns-folder/terraform.tfstate作为远程状态路径，但仍建议通过init -migrate-state让Terraform自动处理，不要手动上传。

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