Terraform 1.10版本中环境变量列表类型解析问题分析

在Terraform 1.10版本中，用户报告了一个与环境变量列表类型处理相关的重要问题。这个问题表现为当使用TF_VAR_前缀的环境变量传递列表类型参数时，terraform plan命令可以正常执行，但在执行terraform apply时会出现"Can't change variable when applying a saved plan"的错误。

问题现象

具体表现为：

1. 用户通过环境变量设置了一个列表类型的变量：

   export TF_VAR_this_is_a_list_variable='["stuff"]'
   

2. 执行terraform plan -input=false -out=plan.tfplan命令时工作正常
3. 但在执行terraform apply plan.tfplan时出现错误：

   Error: Can't change variable when applying a saved plan
   

技术背景

在Terraform中，变量可以通过多种方式传递，包括：

• 直接在配置文件中定义默认值
• 通过命令行参数
• 通过环境变量（使用TF_VAR_前缀）

对于列表类型的变量，Terraform需要正确解析JSON格式的字符串并将其转换为内部的列表数据结构。在1.10版本之前，这个转换过程在plan和apply阶段是一致的，但在1.10版本中出现了不一致的情况。

问题根源

经过分析，这个问题源于Terraform 1.10版本中对环境变量解析逻辑的修改。具体来说：

1. 在plan阶段，Terraform正确地将JSON字符串解析为列表
2. 但在保存plan文件时，可能没有完整保留这个解析后的数据结构
3. 在apply阶段重新读取plan文件时，Terraform尝试重新解析环境变量，但由于某些原因，解析结果与plan阶段不一致

这种不一致导致Terraform的安全机制触发，防止了潜在的配置漂移，从而抛出错误。

影响范围

这个问题主要影响：

• 使用Terraform 1.10版本的用户
• 通过环境变量传递列表类型变量的场景
• 特别是当使用plan/apply分离的工作流程时

解决方案

这个问题已经在后续的修复中得到解决。对于遇到此问题的用户，可以采取以下临时解决方案：

1. 降级到1.9.8版本（确认该版本无此问题）
2. 避免使用环境变量传递列表类型参数，改用其他变量传递方式
3. 等待官方发布包含修复的版本

最佳实践建议

为了避免类似问题，建议：

1. 对于复杂数据类型（如列表、映射），优先使用.tfvars文件而非环境变量
2. 在升级Terraform版本前，先在测试环境中验证关键工作流程
3. 考虑使用CI/CD流水线时，确保plan和apply阶段的环境一致性

这个问题提醒我们基础设施即代码工具中类型系统处理的重要性，以及在版本升级时需要特别注意的兼容性问题。