Terraform部署Azure FrontDoor遇azurerm Provider版本匹配错误求助

架构老林

2026-8-15

解决Terraform AzureRM Provider版本匹配错误问题

我要部署以下Azure FrontDoor的Terraform代码：

resource "azurerm_cdn_frontdoor_profile" "example" {
   name                = "example-cdn-profile"
  resource_group_name = "frdoor-p-to-01"
  sku_name            = "Standard_AzureFrontDoor"
  tags = {
    environment = "Production"
  }
}

运行Azure DevOps流水线时触发错误：

Error: Failed to query available provider packages
Could not retrieve the list of available versions for provider
hashicorp/azurerm: no available releases match the given constraints ~>
3.27.0, 3.28.0

我使用Linux虚拟机托管代理，尝试修改Provider配置中的版本（如下）但问题依旧：

terraform {
  required_providers {
    azurerm = {
      source  = "hashicorp/azurerm"
      #version = "~> 3.27.0"
            version = "=3.28.0"
      #version = "=2.97.0"
    }
}

环境：已安装Terraform的Linux虚拟机托管代理 + Azure DevOps流水线

解决方案：

检查Terraform与Provider版本兼容性
AzureRM Provider 3.x系列要求Terraform版本≥0.14，先确认代理上的Terraform版本：
```
terraform version
```
若版本过低，升级到符合要求的稳定版本（建议≥1.0.0）。
清理Provider缓存
Linux代理上的Terraform缓存目录默认是~/.terraform.d/plugins，删除该目录下hashicorp/azurerm相关文件，重新执行terraform init让Terraform重新拉取指定版本的Provider。

修正版本约束语法
确保版本约束无冲突，不要同时保留多个未注释的版本规则。推荐使用兼容范围或明确的稳定版本：

terraform {
  required_version = ">= 1.0.0"
  required_providers {
    azurerm = {
      source  = "hashicorp/azurerm"
      version = "~> 3.28.0" # 兼容3.28.x所有小版本
      # 或指定最新稳定兼容版本，如version = "3.77.0"
    }
  }
}

验证代理网络连通性
确认Linux代理能正常访问Terraform Registry：
```
curl -I https://registry.terraform.io/v1/providers/hashicorp/azurerm/versions
```
若无法访问，需配置代理服务器或调整防火墙规则允许该域名的HTTPS流量。
Azure DevOps流水线中强制升级Provider
在流水线的Terraform初始化步骤添加-upgrade参数，强制Terraform拉取符合约束的最新版本：
```
terraform init -upgrade
```

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

Terraform部署Azure FrontDoor遇azurerm Provider版本匹配错误求助

解决方案： #

解决方案：