GitHub Actions配置TF_WORKSPACE报Terraform工作区不存在错误

TF_WORKSPACE 环境变量的作用仅为切换到已存在的工作区，本身不会自动创建新工作区。
第一次创建alpha环境能成功，是因为当时S3后端完全没有初始化记录，GitHub Actions Runner也没有任何遗留的Terraform缓存，首次初始化后端时Terraform会顺带创建你指定的第一个非default工作区，属于特殊场景下的隐式行为，不是可稳定复现的逻辑。后续跑流水线时，要么是复用了带.terraform缓存的Runner工作目录，要么是S3后端已经存在default工作区的初始化记录，Terraform不会再自动创建不存在的工作区，就会抛出「选中的工作区beta不存在」的报错。

不要依赖隐式创建行为，在流水线里按固定流程处理工作区：

• 第一步先执行不带TF_WORKSPACE变量的terraform init，完成S3后端的基础初始化
• 第二步显式检查目标工作区是否存在，不存在就主动创建，示例命令：

# 替换为你实际要使用的工作区名称
export TF_WORKSPACE=beta
terraform workspace list | grep -q " ${TF_WORKSPACE}$" || terraform workspace create "$TF_WORKSPACE"

• 检查/创建完成后，再正常执行terraform plan、terraform apply等后续命令即可

• 如果你在GitHub Actions里配置了.terraform目录的缓存，不要依赖缓存里留存的工作区选择状态，每次流水线运行都要显式做一次工作区存在性检查
• 不要在执行terraform init之前就导出TF_WORKSPACE变量，init阶段先完成后端基础初始化，再处理工作区选择/创建，能避免绝大多数工作区相关的初始化报错
• 不要手动在S3存储桶里创建对应名称的目录来模拟工作区，Terraform工作区的元数据存在后端的专属状态记录里，手动创建的目录不会被识别为合法工作区

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