Terragrunt空集合变量传递问题解析与解决方案

问题背景

在Terragrunt 0.65.0版本中，用户发现当在terragrunt.hcl配置文件中定义空集合（空列表或空映射）作为输入变量时，这些变量会被错误地转换为null值传递给底层Terraform模块。这与Terraform/OpenTofu原生行为不一致，也不同于Terragrunt早期版本(如0.64.0)的正确表现。

技术细节分析

该问题具体表现为：

1. 在terragrunt.hcl中定义空列表输入lists = []
2. 定义空映射输入sets = {}
3. 实际传递给模块时这两个变量都变成了null

这种行为差异会导致模块中定义的默认值失效，可能引发以下问题：

• 模块中依赖集合类型变量的逻辑会收到意外的null值
• 与直接使用Terraform/OpenTofu时的行为不一致
• 从旧版本Terragrunt升级时出现兼容性问题

影响范围

该问题影响：

• Terragrunt 0.65.0版本
• 所有集合类型的空值定义（列表和映射）
• 跨平台影响（包括macOS和Linux等）

解决方案

该问题已在Terragrunt 0.66.1版本中修复。用户可以通过以下方式解决：

1. 升级Terragrunt到0.66.1或更高版本
2. 临时解决方案（如果无法立即升级）：
   • 在模块中显式处理可能的null值
   • 使用条件表达式确保变量不为null

最佳实践建议

1. 版本控制：始终明确指定Terragrunt版本，避免意外升级
2. 空值处理：在模块中考虑对集合类型变量进行null检查
3. 测试验证：升级后应验证空集合变量的传递行为
4. 文档记录：在团队内部记录此类兼容性变化

技术原理

该问题的根本原因在于Terragrunt在变量序列化/反序列化过程中对空集合的特殊处理逻辑存在缺陷。修复后的版本改进了变量传递机制，确保：

• 空列表保持为[]
• 空映射保持为{}
• 与Terraform核心行为保持一致

总结

Terragrunt作为Terraform的包装工具，其变量传递机制需要与核心工具保持高度一致。这次的空集合传递问题提醒我们基础设施代码同样需要严格的版本控制和升级测试。建议团队在升级工具链时进行充分的兼容性测试，特别是涉及基础数据类型处理的部分。