Terraform var-file选项失效，外部变量文件无法正常加载

咱们从最常见的问题入手，一步步排查解决：

1. 先确认变量文件的路径是否正确 #

你的terraform.tfvars存放在/home/nford/secrets/，而你是在/home/nford/deployment/prod/目录执行命令，必须用正确的相对路径或绝对路径来引用它：

• 用绝对路径（最稳妥，避免相对路径出错）：

  terraform plan -var-file="$HOME/secrets/terraform.tfvars"
  

• 用相对路径：从prod目录往上跳两级回到/home/nford/，再进入secrets目录，路径写法是：

  terraform plan -var-file="../../secrets/terraform.tfvars"
  

如果你之前用的是../secrets/terraform.tfvars，那会指向/home/nford/deployment/secrets/，这和实际文件位置不符，大概率是导致失效的原因。

2. 验证变量文件的格式是否合规 #

打开/home/nford/secrets/terraform.tfvars，检查变量定义是否符合Terraform的HCL语法：

• 变量名必须和module_01/variables.tf里定义的完全一致
• 正确格式示例：

  # 字符串类型变量
  aws_access_key = "AKIAXXXXXXXXX"
  # 数字类型变量
  instance_count = 3
  # 列表类型变量
  allowed_ports = [22, 80, 443]
  

如果存在引号不闭合、逗号缺失这类语法错误，Terraform会无法解析文件，导致var-file选项失效。

3. 确认当前工作目录的Terraform配置上下文 #

你说在/home/nford/deployment/prod/执行terraform init成功，但要确保这个目录是你的根模块目录：

• 根模块目录下必须有自己的main.tf（通常会包含对module_01的调用，示例如下）：

  module "app_module" {
    source = "./module_01"
    # 变量可以在这里直接传递，也通过var-file传入
  }
  

如果prod目录下没有任何.tf文件，那terraform init其实没有初始化任何有效模块，后续的var-file自然无法生效。这种情况下，你需要切换到module_01目录执行命令，或者在prod目录创建根模块配置来调用module_01。

4. 测试变量是否被正确加载 #

可以用terraform console命令验证变量加载情况：

terraform console -var-file="$HOME/secrets/terraform.tfvars"

在控制台输入变量名（比如var.aws_access_key），如果能输出对应的值，说明变量文件被正确加载；如果提示变量未定义，那要么是路径错误，要么是变量名不匹配，要么是文件格式有问题。

5. 检查Terraform版本兼容性 #

虽然terraform init成功，但如果变量文件使用了较新的HCL语法，而你的Terraform版本过旧，也可能出现解析问题。可以执行terraform version查看版本，必要时升级到稳定版。

内容的提问来源于stack exchange，提问作者Nathaniel Ford