使用Terraform循环创建AWS API Gateway资源时遇循环依赖问题求助

问题根源 #

你的代码存在两个核心问题引发循环依赖：

1. resources_hierarchy 混合了资源ID（根资源ID）和资源名称，导致each.value == aws_api_gateway_rest_api.gatewayh.root_resource_id的判断逻辑失效——each.value对"v0"是动态资源ID，对其他项是字符串名称，类型不匹配的判断让Terraform无法正确解析依赖关系。
2. for_each 默认是无序执行的，Terraform无法自动识别资源的层级创建顺序，必须明确定义父级依赖的逻辑。

修正后的代码 #

第一步：重构层级结构 #

将resources_hierarchy改为纯名称映射，根级资源用null标记：

locals {
  api_endpoints = [
    {
      path           = "v0"
      http_method    = "GET"
      integration_uri = "${uri_path}/v0"
    },
    {
      path           = "v0/expert/gen/btags"
      http_method    = "POST"
      integration_uri = "${uri_path}/v0/expert/gen/btags"
    },
    {
      path           = "v0/expert/generate/tags"
      http_method    = "POST"
      integration_uri = "${uri_path}/v0/expert/gen/tags"
    },
    {
      path           = "v0/expert/search"
      http_method    = "POST"
      integration_uri = "${uri_path}/v0/expert/search"
    },
  ]
  # 纯名称层级映射，根级资源父级设为null
  resources_hierarchy = {
    "v0"     = null
    "expert" = "v0"
    "gen"    = "expert"
    "search" = "expert"
    "btags"  = "gen"
    "tags"   = "gen"
  }
}

第二步：明确资源依赖逻辑 #

修改aws_api_gateway_resource定义，清晰区分根级资源与子资源的父ID配置：

resource "aws_api_gateway_resource" "api_resource" {
  for_each = local.resources_hierarchy

  rest_api_id = aws_api_gateway_rest_api.gatewayh.id
  # 根级资源直接用API的根资源ID，子资源引用对应父资源的ID
  parent_id   = each.value == null ? aws_api_gateway_rest_api.gatewayh.root_resource_id : aws_api_gateway_resource.api_resource[each.value].id
  path_part   = each.key
}

额外优化：自动从接口路径生成层级 #

如果不想手动维护resources_hierarchy，可以从api_endpoints的path自动提取所有资源节点并构建层级，避免手动出错：

locals {
  # 提取所有唯一的路径节点
  all_path_parts = distinct(flatten([
    for endpoint in local.api_endpoints : split("/", endpoint.path)
  ]))
  
  # 自动构建层级：每个节点的父级是其路径的上一级节点
  resources_hierarchy = {
    for part in local.all_path_parts : part => (
      length(split("/", part)) > 1 ? join("/", slice(split("/", part), 0, length(split("/", part))-1)) : null
    )
  }
}

这个方法会自动解析所有需要创建的资源节点，并自动设置父级依赖，无需手动维护层级映射。

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