Terraform 1.10.0版本中TF_VAR环境变量使用问题解析

问题背景

在Terraform 1.10.0版本中，用户在使用TF_VAR环境变量传递复杂数据结构时遇到了一个关键性问题。这个问题特别影响了通过CI/CD流水线（如GitHub Actions）执行terraform apply命令的场景。

问题现象

当用户尝试通过环境变量传递JSON格式的变量值时，Terraform 1.10.0会报错，提示变量不能在使用保存的计划文件时通过-var或-var-file选项设置。值得注意的是，用户实际上并没有使用保存的计划文件，而是直接执行terraform apply命令。

技术细节分析

这个问题的核心在于Terraform 1.10.0对变量处理逻辑的变更。在1.9.8及更早版本中，Terraform能够正确处理通过TF_VAR_前缀环境变量传递的复杂数据结构（如包含多个属性的对象）。但在1.10.0版本中，这种行为发生了变化。

典型的错误场景涉及如下数据结构：

{
  "eu": "arn:aws:iam::11111111:role/pipeline-prod-log-producers-all",
  "non-eu": "arn:aws:iam::1111111111:role/pipeline-prod-log-producers-all"
}

影响范围

这个问题主要影响以下使用场景：

1. 通过环境变量传递复杂数据结构的用户
2. 在自动化流水线中执行Terraform命令的场景
3. 需要动态设置变量值的CI/CD工作流

解决方案

根据核心开发团队的反馈，这个问题已经被识别并修复。修复方案涉及对Terraform变量处理逻辑的调整，确保环境变量能够正确传递复杂数据结构。

最佳实践建议

对于需要临时解决此问题的用户，可以考虑以下方法：

1. 暂时回退到Terraform 1.9.8版本
2. 将复杂变量定义移到.tfvars文件中
3. 等待官方发布包含修复的版本

总结

这个问题展示了基础设施即代码工具在版本迭代过程中可能引入的兼容性问题。对于生产环境中的关键工作流，建议在升级前进行充分的测试，并关注官方的问题跟踪系统以获取最新的修复信息。