Terraform初始化后AWS与AzureRM提供者架构加载失败求助

问题背景 #

本地Terraform自动化测试框架运行正常，但在构建/测试服务器上执行时失败。服务器执行流程：

• 检查并确认.terraform文件夹和锁文件不存在
• 在default工作区执行terraform init
• 确认.terraform和锁文件已创建
• 切换到目标工作区，再次执行terraform init
• 生成自定义tfvars文件
• 在目标工作区使用该变量文件执行apply

错误信息 #

[31mâ•·[0m[0m
[31m│[0m [0m[1m[31mError: [0m[0m[1mFailed to load plugin schemas[0m
[31m│[0m [0m
[31m│[0m [0m[0mError while loading schemas for plugin components: 2 problems:
[31m│[0m [0m
[31m│[0m [0m- Failed to obtain provider schema: Could not load the schema for provider
[31m│[0m [0mregistry.terraform.io/hashicorp/aws: failed to instantiate provider
[31m│[0m [0m"registry.terraform.io/hashicorp/aws" to obtain schema: Unrecognized remote
[31m│[0m [0mplugin message: 
[31m│[0m [0m
[31m│[0m [0mThis usually means that the plugin is either invalid or simply
[31m│[0m [0mneeds to be recompiled to support the latest protocol..
[31m│[0m [0m- Failed to obtain provider schema: Could not load the schema for provider
[31m│[0m [0mregistry.terraform.io/hashicorp/azurerm: failed to instantiate provider
[31m│[0m [0m"registry.terraform.io/hashicorp/azurerm" to obtain schema: Unrecognized
[31m│[0m [0mremote plugin message: 
[31m│[0m [0m
[31m│[0m [0mThis usually means that the plugin is either invalid or simply
[31m│[0m [0mneeds to be recompiled to support the latest protocol...
[31m╵[0m[0m

已尝试删除旧.terraform文件夹、init时使用-upgrade和-reconfigure参数，问题仍存在。

解决方案 #

1. 强制对齐Provider版本 #

本地测试通过的Provider版本与服务器下载的版本可能不兼容，在Terraform配置文件中明确指定版本：

terraform {
  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = "~> 5.10.0" # 替换为本地测试成功的具体版本
    }
    azurerm = {
      source  = "hashicorp/azurerm"
      version = "~> 3.70.0" # 替换为本地测试成功的具体版本
    }
  }
}

重新执行terraform init，确保服务器下载指定版本的Provider。

2. 统一本地与服务器的Terraform版本 #

版本差异是导致插件协议不兼容的常见原因，执行terraform version对比本地和服务器的版本，将服务器的Terraform版本升级/降级至与本地一致。

3. 清理全局插件缓存 #

Terraform会在用户目录下缓存插件（Linux路径：~/.terraform.d/plugins），服务器可能残留旧版本插件，执行以下命令清理：

rm -rf ~/.terraform.d/plugins/registry.terraform.io/hashicorp/aws
rm -rf ~/.terraform.d/plugins/registry.terraform.io/hashicorp/azurerm

之后重新执行terraform init，强制重新下载完整插件。

4. 优化工作区初始化流程 #

当前先在default工作区init再切换的流程可能导致插件加载冲突，建议简化流程：

• 检查并删除.terraform文件夹和锁文件
• 创建并切换到目标工作区：terraform workspace new <target-workspace>（若已存在则用terraform workspace select <target-workspace>）
• 直接执行terraform init -upgrade -reconfigure
• 生成tfvars后执行apply

5. 验证插件下载完整性 #

在init时添加-get-plugins=true参数确保插件完整下载，或手动下载对应版本的Provider插件，上传至服务器的插件目录并设置可执行权限（chmod +x <plugin-file>）。

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