TFC执行terraform plan报provider schemas JSON生成失败(exit 1)如何解决

TFC工作区自某日夜间起，执行terraform plan操作时抛出如下固定错误：

Failed generating provider schemas JSON
Exit code: 1

Operation failed: failed generating provider schemas JSON: failed running command (exit 1)

故障触发无配置变更前提：当前状态文件、Terraform配置代码均未做任何修改，两种触发路径均可稳定复现：

• 本地CLI以远程执行模式运行terraform plan
• TFC GUI界面手动触发计划操作

当前运行环境版本：Terraform v1.2.3
配置依赖的provider清单如下：

terraform providers

Providers required by configuration:
.
├── provider[registry.terraform.io/hashicorp/vault] 3.7.0
├── provider[registry.terraform.io/hashicorp/azuread] 2.25.0
├── provider[registry.terraform.io/microsoft/azuredevops] 0.2.1
├── provider[registry.terraform.io/hashicorp/tfe] 0.32.1
├── module.tfc-configuration
│   └── provider[registry.terraform.io/hashicorp/tfe] 0.32.1
├── module.aad-configuration
│   └── provider[registry.terraform.io/hashicorp/azuread] 2.25.0
└── module.azdo-configuration
    └── provider[registry.terraform.io/microsoft/azuredevops] 0.2.1

Providers required by state:

    provider[registry.terraform.io/hashicorp/azuread]

    provider[registry.terraform.io/hashicorp/tfe]

    provider[registry.terraform.io/hashicorp/vault]

    provider[registry.terraform.io/microsoft/azuredevops]

• 同TFC组织内新建工作区，运行仅创建Azure资源组、公网IP的极简测试Terraform代码，可正常执行无报错，排除TFC平台全局故障
• 已配置TF_LOG=TRACE、TF_LOG_PROVIDER=TRACE参数开启全量trace日志重跑terraform plan，日志输出无有效根因定位信息

1. 锁定故障provider范围 #

• 本地部署和线上一致的v1.2.3版本Terraform环境，编写仅声明单个provider的最小化测试配置，逐个对清单内的provider执行terraform providers schema -json，返回exit code 1的即为故障provider
• 优先排查非HashiCorp官方维护的低版本provider，当前清单内microsoft/azuredevops 0.2.1为最高优先级排查对象：该版本发布时间较早，存在已知的旧版本二进制在Terraform 1.2+版本下schema序列化兼容问题，符合「无配置变更突发故障」的特征——故障触发通常和provider缓存损坏、平台侧拉取的二进制签名校验逻辑更新有关。

2. 排查provider缓存/拉取链路故障 #

• 清空本地Terraform插件缓存目录（Linux/macOS默认路径~/.terraform.d/plugin-cache，Windows默认路径%APPDATA%\terraform.d\plugin-cache），删除工作目录下的.terraform文件夹，重新执行terraform init后跑plan验证
• TFC侧进入工作区设置，开启Clean working directory选项，禁用工作区运行缓存，强制每次执行计划时重新拉取全量provider，排除TFC侧缓存的损坏provider二进制导致的schema生成失败

3. 验证版本兼容性 #

• 本地临时将Terraform版本降级到v1.1.9（1.x系列中对旧版provider兼容性最好的稳定版本）执行plan测试，如果降级后运行正常，可直接确认根因为旧版provider与v1.2.3内置的schema生成逻辑不兼容
• 逐个升级低版本provider到对应大版本下的最新补丁版：优先升级microsoft/azuredevops到0.2.x分支最新版本，其次升级hashicorp/vault 3.7.0到3.7.x分支最新补丁版，每次仅升级一个provider，执行init后跑plan，即可定位具体故障组件

• 临时恢复方案：定位到故障provider后，可先在TFC工作区将Terraform版本锁定为v1.1.9，快速恢复计划/应用流水线可用
• 永久修复方案：将故障provider升级到兼容Terraform 1.2+的版本，升级前必须在测试环境执行terraform plan验证无破坏性资源变更，必要时对状态文件做适配迁移

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