如何将Terraform后端存储账户设为变量？遇变量不允许错误

问题原因 #

Terraform的后端配置块在terraform init阶段就会被加载，这个阶段还未完成变量定义的解析，因此不允许在后端配置中直接引用var.xxx变量，这就是触发Variables not allowed错误的核心原因。

你的配置与报错 #

main.tf #

terraform {
  required_version = ">= 1.3"
  backend "azurerm" {
    resource_group_name  = "rg-tfstate"
    storage_account_name = var.arg5_terraformStorageAccount
    container_name       = "tfstate"
    key                  = "terraform.tfstate"
    
  }
}

variables.tf #

variable "arg5_terraformStorageAccount" {
  type        = string
  description = "terraformStorageAccount (sensitive)"
  sensitive   = true
}

报错信息 #

│ Error: Variables not allowed
│
│ on main.tf line 7, in terraform:
│ 7: storage_account_name = var.arg5_terraformStorageAccount
│
│ Variables may not be used here.

解决方案 #

有三种常用方式可绕过该限制，动态传递后端存储账户名：

1. 初始化时用-backend-config参数传递 #

直接在初始化命令中指定存储账户名：

terraform init -backend-config="storage_account_name=你的存储账户名称"

若需传递多个参数，可将参数写入配置文件（如backend.conf）：

resource_group_name=rg-tfstate
storage_account_name=你的存储账户名称
container_name=tfstate
key=terraform.tfstate

再执行初始化：

terraform init -backend-config=backend.conf

2. 使用环境变量 #

AzureRM后端支持通过环境变量读取配置，设置对应变量即可：

# Linux/macOS
export ARM_STORAGE_ACCOUNT_NAME="你的存储账户名称"

# Windows PowerShell
$env:ARM_STORAGE_ACCOUNT_NAME="你的存储账户名称"

设置后执行terraform init，Terraform会自动读取该环境变量值作为后端存储账户名。

3. 使用部分后端配置 #

修改main.tf中的后端配置，仅保留固定值，将需动态传递的字段留空：

terraform {
  required_version = ">= 1.3"
  backend "azurerm" {
    resource_group_name  = "rg-tfstate"
    container_name       = "tfstate"
    key                  = "terraform.tfstate"
    # 留空storage_account_name，初始化时补充
  }
}

之后通过上述两种方式（-backend-config参数或环境变量）在初始化时传递storage_account_name的值即可。

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