修改Terraform S3后端state路径时如何保证状态文件正确？

直接修改version.tf中的backend key值后，Terraform会将新路径识别为未初始化的空白后端，执行apply操作就会重复创建所有资源。可按照以下步骤操作避免该问题，确保S3 state文件和本地状态同步：

推荐操作流程（官方标准方案） #

• 首先确认当前工作目录无待变更配置，执行terraform plan，输出提示No changes代表旧state状态和现有资源完全匹配。
• 先不要修改version.tf配置，通过AWS CLI将S3上的旧state文件移动到新路径：

  # 移动state文件，也可以用cp命令先复制备份再删除旧文件，更稳妥
  aws s3 mv s3://terraform-bucket/project1/api/terraform.tfstate s3://terraform-bucket/project1/price-api/terraform.tfstate
  

• 修改version.tf中backend配置的key值为新路径project1/price-api/terraform.tfstate。
• 执行terraform init -reconfigure，该命令会重新初始化后端配置，直接读取新路径下的已有state文件，不会生成空白state。
• 验证状态是否正常：执行terraform plan，输出No changes. Your infrastructure matches the configuration.即为同步成功。

备选操作流程（无需手动操作S3） #

如果担心手动操作S3误删文件，可选择本地中转state的方案：

• 先将旧路径的state拉取到本地：terraform state pull > terraform.tfstate
• 修改version.tf中的backend key为新路径
• 执行terraform init -reconfigure，当Terraform提示是否要将本地state上传到新的S3路径时，输入yes确认
• 上传完成后删除本地的terraform.tfstate文件，执行terraform plan验证状态即可。

注意事项 #

• 操作前建议先备份旧state文件，可执行aws s3 cp s3://terraform-bucket/project1/api/terraform.tfstate ./terraform.tfstate.backup生成本地备份。
• 如果配置了DynamoDB state锁，操作过程中出现锁冲突时，确认无其他用户同时执行Terraform操作后，可通过terraform force-unlock <锁ID>解锁。
• 同步完成后可手动删除S3旧路径下的state文件，避免后续配置混淆。

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