Terragrunt中ignorable_errors配置的多行错误匹配问题解析

问题背景

在使用Terragrunt进行基础设施部署时，开发人员经常会遇到需要忽略某些已知错误的情况。Terragrunt提供了ignorable_errors配置项来帮助处理这类场景，但实际使用中可能会遇到配置不生效的问题。

典型错误场景

在AWS环境中创建路由表条目时，如果指定的Transit Gateway不存在，系统会返回如下错误信息：

Error: creating Route in Route Table (rtb-037af000c0add21c4) with destination (10.0.0.0/8): operation error EC2: CreateRoute, https response error StatusCode: 400, RequestID: df928005-0654-0000-0000-301551a785b3, api error InvalidTransitGatewayID.NotFound: The transitGateway ID 'tgw-xxxxxxxxxxxxxx' does not exist.

配置尝试

开发人员通常会尝试在terragrunt.hcl中添加如下配置：

errors {
  ignore "transit_gateway_errors" {
    ignorable_errors = [
      ".*Error: creating Route in Route Table.*"
    ]
    message = "Ignoring transit gateway not found when creating internal route."
  }
}

问题根源

这种配置不生效的主要原因是错误信息实际上是以多行格式输出的，而简单的单行正则表达式无法匹配完整的错误信息。真实的错误输出格式如下：

Error: creating <-----
Route in Route Table (rtb-037af000c0add21c4) with destination (10.0.0.0/8):
operation error EC2: CreateRoute, https response error StatusCode: 400,
RequestID: df928005-0654-0000-0000-301551a785b3, api error
InvalidTransitGatewayID.NotFound: The transitGateway ID
'tgw-xxxxxxxxxxxxxx' does not exist.

解决方案

要正确处理多行错误信息，需要调整正则表达式模式：

1. 使用(?s)标志启用"点匹配所有"模式，使.也能匹配换行符
2. 确保正则表达式能覆盖错误信息的开头和关键特征

改进后的配置示例：

errors {
  ignore "transit_gateway_errors" {
    ignorable_errors = [
      "(?s).*Error:.*creating Route in Route Table.*InvalidTransitGatewayID\.NotFound.*"
    ]
    message = "Ignoring transit gateway not found error."
  }
}

最佳实践

1. 在开发环境中重现错误，获取完整的错误输出
2. 使用正则表达式测试工具验证模式匹配
3. 尽量包含错误信息中的独特标识符（如错误代码）
4. 在非关键环境中测试配置效果
5. 记录被忽略的错误类型及其业务影响

总结

Terragrunt的ignorable_errors功能是处理已知错误的有效工具，但需要注意错误信息的实际输出格式可能是多行的。通过使用适当的多行匹配模式和全面的正则表达式，可以确保配置按预期工作。这个问题在Terragrunt v0.72.4版本中得到了官方确认和解决。