如何将现有Terraform资源从单个项迁移到集合，避免资源重建？

问题场景 #

原本通过单个资源块定义Google SQL数据库：

resource "google_sql_database" "projects" {
  name     = "projects"
  instance = google_sql_database_instance.database.name
}

resource "google_sql_database" "markdown" {
  name     = "markdown"
  instance = google_sql_database_instance.database.name
}

改为使用for_each结合变量集合批量配置后：

variable "databases" {
  type    = list(string)
  default = ["projects", "markdown"]
}

resource "google_sql_database" "database" {
  for_each = toset(var.databases)
  name     = each.key
  instance = google_sql_database_instance.database.name
}

执行terraform apply时，CLI提示会销毁旧资源并创建新资源：

# module.sql.google_sql_database.database["markdown"] will be created
+ resource "google_sql_database" "database" {
...
...

# module.sql.google_sql_database.markdown will be destroyed
- resource "google_sql_database" "markdown" {
...
...

解决方案 #

通过迁移Terraform状态，将旧资源地址映射到新的for_each资源地址，避免重建：

1. 查看当前资源状态
   执行以下命令确认旧资源的完整地址：

terraform state list

输出会包含：

module.sql.google_sql_database.projects
module.sql.google_sql_database.markdown

2. 迁移资源状态
   针对每个数据库，执行terraform state mv命令，将旧资源地址迁移到新的for_each对应的地址：

# 迁移projects数据库状态
terraform state mv "module.sql.google_sql_database.projects" "module.sql.google_sql_database.database[\"projects\"]"

# 迁移markdown数据库状态
terraform state mv "module.sql.google_sql_database.markdown" "module.sql.google_sql_database.database[\"markdown\"]"

3. 验证配置
   执行terraform plan检查，此时Terraform会识别到资源已存在，不会再提示销毁和重建。

原因说明 #

Terraform通过资源唯一地址（资源类型+名称+键/索引）识别资源实例。旧配置中资源地址为google_sql_database.projects，新配置中为google_sql_database.database["projects"]，地址不匹配导致Terraform认为是完全不同的资源，因此会执行销毁重建。状态迁移后，Terraform会将新地址与现有资源实例关联，从而避免不必要的资源变动。

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