GitHub上GCP Terraform CICD流水线执行失败求助

问题场景 #

在GitHub Actions中运行Terraform GCI/CD流水线时，执行terraform plan -input=false触发以下错误：

Run terraform plan -input=false
/home/runner/work/_temp/86fbf72d-0d05-43a8-9ea3-6c50d50b0210/terraform-bin plan -input=false
╷
│ Error: Required plugins are not installed
│ 
│ The installed provider plugins are not consistent with the packages
│ selected in the dependency lock file:
│   - registry.terraform.io/hashicorp/google: there is no package for registry.terraform.io/hashicorp/google 5.24.0 cached in .terraform/providers
│ 
│ Terraform uses external plugins to integrate with a variety of different
│ infrastructure services. To download the plugins required for this
│ configuration, run:
│   terraform init

已尝试以下操作但未解决：

terraform init -upgrade
Remove-Item -Path ".terraform/providers" -Recurse -Force
terraform init

解决步骤 #

1. 确保流水线中terraform init前置执行 #

GitHub Actions runner为临时环境，每次运行无缓存状态，必须在terraform plan前明确执行初始化步骤，避免跳过或遗漏。修改流水线配置：

- name: Terraform 初始化
  run: terraform init

- name: Terraform 执行计划
  run: terraform plan -input=false

2. 重置锁文件并重新初始化 #

代码库中的.terraform.lock.hcl可能存在本地与runner环境的版本差异，尝试强制生成新锁文件：

terraform init -lockfile=force

或在流水线中先删除旧锁文件再执行初始化：

- name: 删除旧锁文件
  run: rm -f .terraform.lock.hcl

- name: Terraform 初始化
  run: terraform init

3. 对齐Terraform版本 #

确保流水线使用的Terraform版本与本地测试版本一致，不同版本对provider的处理逻辑可能存在差异。在流水线中指定固定版本：

- name: 安装指定版本Terraform
  uses: hashicorp/setup-terraform@v2
  with:
    terraform_version: "1.5.7" # 替换为你本地使用的版本号

4. 彻底清理Terraform缓存目录 #

在runner中清理所有Terraform相关缓存文件，消除残留文件影响：

- name: 清理Terraform缓存
  run: |
    rm -rf .terraform
    rm -rf .terraform.lock.hcl

- name: Terraform 初始化
  run: terraform init

5. 检查Provider源配置 #

确认Terraform配置文件（如providers.tf）中Google Provider的源为官方registry，避免自定义源导致拉取失败：

terraform {
  required_providers {
    google = {
      source  = "hashicorp/google"
      version = "5.24.0"
    }
  }
}

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