如何让Terraform在TF_VAR环境变量为空时使用变量默认值

根本原因 #

Terraform 本身的设计逻辑是：只要检测到存在对应TF_VAR_*前缀的环境变量，无论变量值是否为空，都会优先将该值作为变量输入，不会自动回退到变量块定义的默认值。你遇到的报错是因为空字符串无法匹配你定义的number类型要求。

可行方案 #

• 方案1：shell层预处理（无需修改TF代码，推荐）

如果是在shell环境中执行Terraform命令，执行前先判断环境变量是否为空，为空则直接移除该变量即可，Terraform检测不到变量存在就会自动使用默认值。
示例shell代码：

# 判断TF_VAR_test是否为空，为空则unset
[ -z "$TF_VAR_test" ] && unset TF_VAR_test
# 再执行Terraform命令
terraform plan

• 方案2：修改TF变量定义适配空值场景

如果无法控制环境变量的传入逻辑（比如CI/CD流程固定会传递所有变量），可以调整变量定义兼容空值，内部做转换后使用：

1. 修改变量类型为string，设置默认值为空字符串
2. 新增local变量做类型转换和默认值兜底
   示例TF代码：

variable "test" {
  type    = string
  default = ""
}

# 内部转换使用的兜底变量
locals {
  test = var.test != "" ? tonumber(var.test) : 1
}

后续代码中所有需要用到该数值的位置，统一使用local.test代替var.test即可。

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