使用Github Actions+Terraform创建仓库时遇401凭证错误的解决方法

我尝试通过Terraform结合GitHub Actions创建GitHub仓库，设置以push事件触发工作流，但每次推送后执行terraform apply时都会出现如下错误：

[Error: POST https://api.github.com/user/repos: 401 Bad credentials []
│
│ with github_repository.github-repo-1,
│ on main.tf line 5, in resource "github_repository" "github-repo-1":
│ 5: resource github_repository github-repo-1 {}

我的provider配置文件（provider.tf）内容如下：

terraform {
      required_providers {
        github = {
          source  = "integrations/github"
          version = "~> 4.0"
        }
      }
    }
    provider "github" {
        token = var.Token
        owner = var.Owner
    }

可行的解决方法 #

• 检查GitHub Token权限
  确保使用的Personal Access Token（PAT）拥有足够权限：

  • 至少勾选repo权限（创建私有仓库需额外勾选repo:status、repo_deployment等子权限）
  • 若操作组织仓库，需在组织设置中授予该Token对应的操作权限，确保Token能访问组织资源
  • 禁止使用只读权限Token，创建仓库要求写入权限

• 确认Token在GitHub Actions中的传递逻辑

  • 在仓库「Settings → Secrets and variables → Actions」中添加名为TOKEN的秘密变量，值为你的PAT
  • 在GitHub Actions工作流文件（如.github/workflows/terraform.yml）中，通过env: TOKEN: ${{ secrets.TOKEN }}将变量传递给Terraform，或直接设置为环境变量GITHUB_TOKEN（注意官方默认GITHUB_TOKEN权限有限，建议使用自定义PAT）
  • 确保工作流中通过terraform apply -var="Token=${{ secrets.TOKEN }}"或terraform.tfvars引用环境变量的方式，正确将Token注入到var.Token中

• 验证Token有效性

  • 用curl直接测试：curl -H "Authorization: token YOUR_TOKEN" https://api.github.com/user
  • 若返回401，说明Token已过期、被撤销或权限配置错误，需重新生成符合要求的Token

• 检查Terraform变量配置

  • 确认var.Token和var.Owner已正确赋值：var.Owner需设置为个人用户名或组织名称，变量名无拼写错误
  • 禁止在代码中硬编码Token，必须通过环境变量或秘密变量传递

• 核对GitHub Provider配置

  • 确认~>4.0版本的GitHub Provider与当前Token格式兼容，配置无语法错误
  • 操作组织仓库时，owner字段必须设置为组织名称，而非个人用户名

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