Terraform Plan无变更却提示CloudSQL资源原地更新的原因与解决

问题场景 #

定义的CloudSQL Terraform资源如下：

resource "google_sql_database_instance" "myCloudSql" {
  name             = "my-sql-name-${var.environment}"
  region           = var.region
  database_version = "POSTGRES_##"

  depends_on = [
   ...
  ]

  settings {
    tier              = "db-f1-micro"
    availability_type = "ZONAL"
    disk_size         = var.diskSize
    disk_type         = var.diskType

    backup_configuration {
      enabled = true
    }

    ip_configuration {
      ipv4_enabled    = true
      private_network = var.myVpcId

      ...
      
    }
  }
}

执行terraform plan后输出：

# module.myCloudSql.google_sql_database_instance.myCloudSql will be updated in-place
  ~ resource "google_sql_database_instance" "myCloudSql" {
        id                             = "my-sql-name-env"
        name                           = "my-sql-name-env"
        # (14 unchanged attributes hidden)

        # (2 unchanged blocks hidden)
    }

明明未修改资源配置，却提示要执行in-place更新。

常见原因 #

• 隐式默认属性差异：Cloud SQL后端会自动填充一些未在Terraform代码中显式定义的属性（比如maintenance_window、pricing_plan），这些属性在Terraform状态文件中没有记录，每次plan时Terraform会检测到API返回值与状态的差异，误判为需要更新。
• Provider版本Bug：旧版本的Google Cloud Terraform Provider对某些属性的处理存在缺陷，导致无意义的变更提示。
• 状态与实际资源不同步：Terraform状态文件可能因为某些原因（比如手动修改了CloudSQL资源）与实际资源状态不一致。
• 敏感/计算属性的细微差异：部分由后端生成的属性（如service_account_email、connection_name）可能存在格式或大小写的细微差异，被Terraform识别为变更。

解决方法 #

• 显式定义所有可选属性：将CloudSQL资源中所有可选的属性（比如settings下的maintenance_window、storage_auto_resize等）都显式设置为固定值，避免后端自动生成的默认值干扰。示例：

  settings {
    # 原有属性
    tier              = "db-f1-micro"
    availability_type = "ZONAL"
    disk_size         = var.diskSize
    disk_type         = var.diskType
  
    # 新增显式定义的可选属性
    maintenance_window {
      day  = 7
      hour = 0
    }
    storage_auto_resize = true
    pricing_plan        = "PER_USE"
  
    # 原有子块
    backup_configuration {
      enabled = true
    }
  
    ip_configuration {
      ipv4_enabled    = true
      private_network = var.myVpcId
      ...
    }
  }
  

• 更新Google Provider到最新稳定版：在versions.tf中指定最新的Google Provider版本，比如：

  provider "google" {
    version = "~> 4.0"
    region  = var.region
  }
  

  执行terraform init -upgrade完成升级。
• 同步状态与实际资源：执行terraform refresh命令，让Terraform重新拉取资源的实际状态并更新本地状态文件，之后再执行terraform plan验证。
• 查看详细变更差异：使用terraform plan -refresh-only命令只刷新状态并检查差异，或者添加-debug参数查看完整的属性对比日志，定位具体触发变更的属性。
• 检查变量依赖：确认var.diskSize、var.diskType等变量的值是否真的未发生变化，包括变量的默认值、依赖的其他资源输出是否有变更。

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