Terraform yamldecode解析YAML结构变更时失败问题排查

问题情况 #

一开始的YAML结构用下面的Terraform locals能正常解析：

alerts:
   la:
     la1:
       description: "la1"
       severity: 1
       resource_counter: "004"
       enabled: true
   ma:
     ma1:
       description: "ma1"
       severity: 2
       enabled: true
       resource_counter: "002"
     ma2:
       description: "ma2"
       severity: 2
       enabled: true
       resource_counter: "003"

对应的Terraform代码：

locals {
  all_alerts     = try(coalesce(yamldecode(file("${path.root}/alerts.yaml"))["alerts"], {}), {})
  metric_alerts  = try(local.all_alerts["ma"], {})
  log_alerts     = try(local.all_alerts["la"], {})
}

但给ma2加了scopes数组后，所有locals解析结果全为空：

alerts:
   la:
     la1:
       description: "la1"
       severity: 1
       resource_counter: "004"
       enabled: true
   ma:
     ma1:
       description: "ma1"
       severity: 2
       enabled: true
       resource_counter: "002"
     ma2:
       description: "ma2"
       severity: 2
       enabled: true
       resource_counter: "003"
       scopes:
           - "test"

奇怪的是把la部分删掉，解析又恢复正常。

问题根源 #

1. YAML缩进不规范：新加的scopes列表项缩进与其他属性不一致，导致YAML解析器无法识别正确层级，直接解析失败。
2. 错误被try静默掩盖：原locals中的try块将解析错误直接转为空对象，看不到真实问题所在。

解决办法 #

第一步：修正YAML缩进 #

整个YAML文件统一使用一种缩进规则（推荐2个或4个空格），子元素的缩进必须比父元素多固定数量。修正后的YAML示例（统一用4空格）：

alerts:
    la:
        la1:
            description: "la1"
            severity: 1
            resource_counter: "004"
            enabled: true
    ma:
        ma1:
            description: "ma1"
            severity: 2
            enabled: true
            resource_counter: "002"
        ma2:
            description: "ma2"
            severity: 2
            enabled: true
            resource_counter: "003"
            scopes:
                - "test"

第二步：优化Terraform错误处理 #

去掉冗余的coalesce，添加临时输出方便排查问题：

locals {
  # 直接解析YAML，不吞错误，便于调试
  raw_alerts = yamldecode(file("${path.root}/alerts.yaml"))
  all_alerts = try(local.raw_alerts["alerts"], {})
  metric_alerts = try(local.all_alerts["ma"], {})
  log_alerts = try(local.all_alerts["la"], {})
}

# 临时输出解析后的原始数据，验证结构是否正确
output "raw_alerts_debug" {
  value = local.raw_alerts
}

如果YAML格式正确，raw_alerts_debug会输出完整结构；如果仍有问题，Terraform会直接抛出错误，明确指出问题点（比如缩进错误）。

第三步：验证解析结果 #

执行terraform plan，查看raw_alerts_debug的输出，确认alerts结构完整，metric_alerts和log_alerts能正确获取对应的值即可。

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