如何在S3中按环境动态配置Terraform远程tfstate文件存储路径

你原有代码的核心限制是：Terraform 后端配置在初始化阶段最先加载，此时自定义变量还未完成解析，因此无法直接在terraform {}的backend块中引用var.ENV变量，该写法会直接触发初始化报错。

方案1：后端部分配置 + 初始化传参 #

该方案适合各环境配置差异较大的场景，具体实现如下：

1. 先修改配置，移除backend块中需要动态赋值的key参数：

variable "ENV" {
  type        = string
  default     = "dev"
  # 增加校验限制可选值
  validation {
    condition     = contains(["dev", "stage", "prod"], var.ENV)
    error_message = "环境参数仅支持 dev、stage、prod 三个可选值。"
  }
}

provider "aws" {
  region = "us-west-2"
}

# 仅保留公共的后端配置，动态参数留空待初始化时传入
terraform {
  backend "s3" {
    bucket = "my-bucket-12345"
    region = "us-west-2"
  }
}

resource "aws_instance" "example" {
  ami           = "ami-0d729a60"
  instance_type = "t2.micro"
}

2. 执行初始化命令时通过-backend-config参数传入对应环境的key路径：

# dev 环境初始化
terraform init -backend-config="key=proj/dev/terraform.tfstate"

# prod 环境初始化
terraform init -backend-config="key=proj/prod/terraform.tfstate"

也可以封装为shell脚本简化操作：

# 执行前传入环境参数即可，例：sh init.sh dev
#!/bin/bash
TF_ENV=$1
terraform init -backend-config="key=proj/${TF_ENV}/terraform.tfstate"

方案2：Terraform 内置工作区（Workspace，轻量多环境首选） #

Terraform 原生提供工作区能力，专门用于同一套配置对应多套环境的场景，无需手动拼接状态路径，操作更简洁：

1. 无需修改后端的基础配置，执行命令创建对应环境的工作区：

# 创建三个环境对应的工作区
terraform workspace new dev
terraform workspace new stage
terraform workspace new prod

2. 切换到对应环境的工作区后，所有apply操作的状态会自动隔离存储，S3中会自动生成env:/[工作区名称]/前缀的路径存储状态文件：

# 切换到dev环境
terraform workspace select dev
# 此时执行apply会自动操作dev环境的状态，无需额外参数
terraform apply

还可以在配置中直接引用当前工作区实现环境差异化配置：

locals {
  # 生产环境使用更大规格的实例，开发测试环境用小规格
  instance_type = terraform.workspace == "prod" ? "t3.large" : "t2.micro"
}

resource "aws_instance" "example" {
  ami           = "ami-0d729a60"
  instance_type = local.instance_type
}

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