如何在Terraform中维持数组顺序且添加新项时不重建资源

问题背景 #

模块接受按依赖顺序排列的对象数组作为变量，需按顺序创建资源（后项依赖前项）：

• 最初使用count：数组中间插入新项时，后续资源会因索引变化全部销毁重建，不符合预期
• 改用for_each：通过唯一键避免了资源重建，但映射的无序性导致资源创建顺序不符合依赖要求；尝试用depends_on时，发现该参数无法直接使用动态键引用前序资源

解决方案 #

核心思路是用稳定唯一键维持for_each的资源持久性，同时通过动态依赖维护创建顺序：

1. 为每个资源生成唯一且稳定的键（避免因数组索引变化导致资源重建）
2. 在本地值中记录每个资源的前序依赖键
3. 利用Terraform支持的动态depends_on列表（或隐式属性引用），让资源自动依赖前序资源，确保创建顺序正确

代码示例 #

1. 变量定义 #

variable "groups" {
  type = map(list(object({
    name = string
    foo  = list(string)
    bar  = number
  })))
}

2. 处理依赖关系的本地值 #

locals {
  # 扁平化分组并生成每个项的唯一键与前序依赖键
  items = flatten([
    for group_key, group_items in var.groups : [
      for idx, item in group_items : {
        unique_key = "${group_key}-${item.name}"
        group_name = group_key
        item       = item
        prev_key   = idx == 0 ? null : "${group_key}-${group_items[idx-1].name}"
      }
    ]
  ])

  # 转换为映射，用于for_each
  items_map = { for item in local.items : item.unique_key => item }
}

3. 资源创建（带动态依赖） #

resource "group" "this" {
  for_each = local.items_map

  group = each.value.group_name
  name  = each.value.item.name

  # 动态生成依赖列表：仅当前项有前序资源时添加依赖
  depends_on = each.value.prev_key != null ? [group.this[each.value.prev_key]] : []
}

替代方案（隐式属性引用） #

如果资源本身需要前序资源的属性（比如父资源ID），可以直接通过属性引用建立隐式依赖，无需显式depends_on：

resource "group" "this" {
  for_each = local.items_map

  group           = each.value.group_name
  name            = each.value.item.name
  parent_group_id = each.value.prev_key != null ? group.this[each.value.prev_key].id : null
}

说明 #

• unique_key使用分组键-项名称的组合，确保数组插入新项时，原有资源的键不会变化，避免销毁重建
• 动态depends_on列表会根据prev_key自动添加前序资源依赖，Terraform会严格按照依赖顺序创建资源
• 该方案适用于所有Terraform Provider（包括AWS），具备通用性

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