通过GitHub Actions部署到Terraform Cloud时突然报错‘Invalid workspaces configuration’

看起来你遇到的问题是Terraform现在严格执行了「工作区配置二选一」的规则，虽然你没在代码里写name字段，但TF_WORKSPACE环境变量的设置会被Terraform解析为隐式指定工作区名称，这就和你配置的tags策略冲突了，所以触发了报错。

我来帮你梳理下问题根源和解决办法：

问题到底出在哪？ #

之前你的方案能正常工作，大概率是旧版本的Terraform对这种场景的校验没那么严格，但最近GitHub Actions里的Terraform版本可能更新了（或者Terraform Cloud的API做了调整），现在明确要求：在cloud块的workspaces配置里，tags和name只能用其中一种——而你设置的TF_WORKSPACE相当于给Terraform传递了「使用指定名称工作区」的指令，和你代码里的tags策略直接冲突。

两种解决思路，按需选择 #

1. 保留多工作区的tags策略（推荐）

既然你原本的设计是用tags复用代码到多个工作区，那只需要移除GitHub Actions里的TF_WORKSPACE环境变量就行。Terraform会自动根据你cloud块里的tags，匹配Terraform Cloud中带对应标签的工作区；如果不存在符合条件的工作区，还会自动创建带这些标签的新工作区。

修改你的GitHub Actions配置，删掉这一行：

TF_WORKSPACE: payment-service-infrastructure-dev

2. 改为固定单一工作区

如果你确实需要固定部署到某个特定名称的工作区，那就要把代码里的tags配置改成name：

terraform {
  required_providers {
    aws = {
      source = "hashicorp/aws"
    }
  }
  cloud {
    hostname     = "app.terraform.io"
    organization = "My-Org"
    workspaces {
      name = "payment-service-infrastructure-dev" # 替换为你的目标工作区名称
    }
  }
}

这种方式的缺点是无法再用tags复用代码到多个工作区，适合单一工作区的场景。

为什么本地没报错？ #

大概率是你本地没有设置TF_WORKSPACE环境变量，所以Terraform只会遵循代码里的tags配置，不会触发冲突。你可以试试在本地手动设置TF_WORKSPACE再执行init，应该也会出现同样的报错，这样就能验证这个问题了。

另外也建议检查下GitHub Actions里使用的Terraform版本，是不是最近升级到了某个新版本导致行为变化。可以在Actions里固定Terraform版本（比如用hashicorp/setup-terraform action时指定version参数），和你本地的版本保持一致，看看会不会解决问题。

备注：内容来源于stack exchange，提问作者baynezy