如何排查Terraform从本地registry安装azurerm v2.61.0 provider无限卡住的问题

命名规范校验 #

• 执行命令查看当前Terraform版本：
  terraform version
• 列出本地Registry对应目录下的所有文件：

Get-ChildItem "C:\path\to\registry.terraform.io\hashicorp\azurerm\2.61.0\windows_amd64"

手动迁移到私有本地Registry的Provider文件需要符合官方命名规范，Windows环境下必须命名为terraform-provider-azurerm_v2.61.0.exe，你提到的_x5是官方缓存的平台标识后缀，手动迁移时需要删除该后缀、补充.exe扩展名，否则Terraform会无法识别有效Provider文件导致无限扫描。

文件完整性与权限校验 #

• 计算本地Provider文件的SHA256哈希，和官方发布的对应版本哈希值对比，确认文件没有损坏：

Get-FileHash "C:\path\to\registry.terraform.io\hashicorp\azurerm\2.61.0\windows_amd64\terraform-provider-azurerm_v2.61.0_x5" -Algorithm SHA256

• 检查目录与文件权限，确认运行Terraform的用户对该路径有可读、可执行权限：

icacls "C:\path\to\registry.terraform.io\hashicorp\azurerm\2.61.0\windows_amd64"

安装链路排查 #

• 清空项目本地缓存的Provider文件，避免缓存冲突：

terraform providers lock -platform=windows_amd64

• 单独执行初始化操作，将Trace日志输出到本地文件方便回溯：

set TF_LOG=TRACE && set TF_LOG_PATH=terraform_install.log && terraform init -upgrade=false

卡住后终止进程，查看日志末尾的调用栈，确认是卡在文件扫描、校验还是执行环节。

配置校验 #

• 查看当前生效的Provider镜像配置，确认filesystem_mirror的路径和你存放Provider的路径完全匹配：

terraform providers mirror -list

• 若使用旧版本Terraform没有上述命令，直接打开%APPDATA%\terraform.rc文件，检查路径的分隔符、大小写是否存在拼写错误。

场景排除测试 #

• 临时重命名terraform.rc文件禁用私有Registry配置，将Provider文件直接放到当前项目的.terraform/providers/registry.terraform.io/hashicorp/azurerm/2.61.0/windows_amd64目录下，再次执行terraform init测试。如果可以正常安装，说明问题出在私有Registry配置或文件命名，与Provider文件本身无关。
• 临时关闭Windows Defender实时保护或第三方杀毒软件后重试，安全软件拦截未签名可执行文件运行是Windows环境下Terraform Provider安装卡住的高频原因。

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