4. Terraform HCL语法进阶：条件表达式、for循环、动态块在熔断配置中的应用

在熔断器配置场景中，基础设施往往需要根据环境、区域或服务状态动态调整参数。Terraform HCL 提供的条件表达式、for 循环和动态块（dynamic block）正是实现这种弹性编排的核心语法工具。掌握它们，你就能用最少的代码覆盖最多的熔断配置变体。

4.1 条件表达式：按环境切换熔断阈值

条件表达式 condition ? true_val : false_val 是 HCL 中最直接的分支手段。在熔断器配置中，常用于区分生产与预发环境的断路器参数。

# 根据环境变量选择熔断阈值
variable "env" {
  type    = string
  default = "staging"
}

locals {
  # 生产环境使用更保守的阈值
  circuit_breaker_timeout = var.env == "production" ? 30 : 10
  error_threshold_percent = var.env == "production" ? 5 : 15
}

resource "consul_config_entry" "service_resolver" {
  kind = "service-resolver"
  name = "payment-svc"

  config_json = jsonencode({
    ConnectTimeout = local.circuit_breaker_timeout
    FailoverPolicy = {
      ErrorThresholdPercentage = local.error_threshold_percent
    }
  })
}

4.2 for循环：批量生成熔断规则

for 表达式可以遍历列表、集合或映射，生成新的结构体。在熔断配置中，常用于将一组服务名批量转换为断路器策略。

# 定义需要熔断保护的服务列表
variable "protected_services" {
  type = list(string)
  default = ["payment", "inventory", "notification"]
}

locals {
  # 为每个服务生成断路器配置映射
  circuit_breaker_configs = {
    for svc in var.protected_services :
    svc => {
      name    = "${svc}-cb"
      max_retries     = 3
      timeout_seconds = 15
    }
  }
}

# 输出生成的配置
output "cb_configs" {
  value = local.circuit_breaker_configs
}

for 还支持过滤：

# 只对核心服务启用严格熔断
locals {
  core_services = ["payment", "auth"]
  strict_cb_configs = {
    for svc in var.protected_services :
    svc => {
      strict_mode = contains(local.core_services, svc) ? true : false
    }
  }
}

4.3 动态块：灵活生成嵌套配置

动态块（dynamic block）是 HCL 中处理可变数量嵌套块的标准方式。在熔断器配置中，当断路器规则的数量或结构在运行时才能确定时，动态块是唯一的选择。

# 定义熔断规则列表
variable "breaker_rules" {
  type = list(object({
    name     = string
    interval = number
    ratio    = number
  }))
  default = [
    { name = "high-latency", interval = 60, ratio = 0.1 },
    { name = "error-burst",  interval = 30, ratio = 0.05 },
  ]
}

resource "consul_config_entry" "service_router" {
  kind = "service-router"
  name = "api-gateway"

  dynamic "route" {
    for_each = var.breaker_rules
    content {
      match {
        http {
          path_prefix = "/api/${route.value.name}"
        }
      }
      destination {
        service = "fallback-${route.value.name}"
        request_timeout = "${route.value.interval}s"
        num_retries    = 2
      }
    }
  }
}

4.4 三种语法的对比与选择

语法	适用场景	输出类型	熔断配置示例
条件表达式	根据单个条件选择值	标量或简单对象	按环境选择超时时间
for 循环	批量转换列表/映射	列表、映射、集合	为多个服务生成断路器参数
dynamic 块	生成可变数量的嵌套块	资源内部的子块	动态路由规则、熔断策略块

4.5 综合案例：熔断器配置工厂

以下示例将三种语法组合使用，构建一个可根据输入动态生成完整熔断器配置的模块：

# 输入：服务列表与熔断策略
variable "services" {
  type = map(object({
    enabled          = bool
    timeout_seconds  = number
    retry_policy     = optional(string, "default")
  }))
}

locals {
  # 条件表达式：过滤出启用的服务
  active_services = {
    for name, svc in var.services : name => svc if svc.enabled
  }

  # for循环：为每个服务生成熔断参数
  cb_params = {
    for name, svc in local.active_services : name => {
      timeout = svc.timeout_seconds > 0 ? svc.timeout_seconds : 10
      retry   = svc.retry_policy == "aggressive" ? 5 : 2
    }
  }
}

resource "consul_config_entry" "service_splitter" {
  for_each = local.cb_params

  kind = "service-splitter"
  name = each.key

  # 动态块：根据重试策略生成不同数量的子块
  dynamic "split" {
    for_each = each.value.retry > 3 ? [1, 2] : [1]
    content {
      weight = split.key == 1 ? 80 : 20
      destination {
        service = each.key
        request_timeout = "${each.value.timeout}s"
      }
    }
  }
}

4.6 常见陷阱与避坑指南

• 动态块内引用错误：dynamic 块内部必须使用 content 块中的 xxx.value 访问当前迭代值，不能直接引用外部变量。
• for 表达式副作用：for 是纯函数式操作，不能在其中执行资源创建或状态修改。
• 条件表达式嵌套过深：超过两层三元运算会严重降低可读性，建议拆分为多个 locals 变量。
• 动态块与 for_each 冲突：不要在同一个资源上同时使用 for_each 和 dynamic 生成同名块，会导致计划错误。