Terraform初始化报错：无法查询可用Provider包求助

问题背景 #

作为Terraform新手，尝试创建本地文件，main.tf代码如下：

resource local_file sample_res {
  filename = "sample.txt"
  content = "I learn terraform"
}

执行terraform init时出现错误：

C:\tf-workspace\first-tf-script>terraform init

Initializing the backend...

Initializing provider plugins...
- Finding latest version of hashicorp/local... ╷ │ Error: Failed to query available provider packages │ │ Could not retrieve the list of available versions for provider hashicorp/local: could not connect to registry.terraform.io: Failed to request discovery document: Get "https://registry.terraform.io/.well-known/terraform.json": dial tcp: lookup registry.terraform.io: no such host ╵

解决步骤 #

• 检查网络连通性
  打开命令提示符，执行ping registry.terraform.io或curl https://registry.terraform.io/.well-known/terraform.json，确认是否能正常访问目标地址。如果无法连通，说明网络存在拦截或DNS解析问题。

• 修复DNS解析
  更换公共DNS服务器，比如谷歌的8.8.8.8或Cloudflare的1.1.1.1：

  1. 右键任务栏网络图标 → 选择「网络和Internet设置」
  2. 点击「更改适配器选项」
  3. 右键当前使用的网络连接 → 选择「属性」
  4. 找到「Internet协议版本4 (TCP/IPv4)」，双击打开
  5. 选择「使用下面的DNS服务器地址」，输入上述公共DNS，点击确定后重启网络。

• 配置代理（如果需要）
  若网络需通过代理访问外网，在命令提示符中临时设置代理环境变量：

  set HTTP_PROXY=http://你的代理地址:端口
  set HTTPS_PROXY=http://你的代理地址:端口
  

  设置完成后重新执行terraform init。长期使用可将代理变量添加到系统环境变量中。

• 手动安装Provider
  若网络问题无法解决，可手动下载并部署hashicorp/local Provider：

  1. 确定本地Terraform支持的Provider版本，选择对应系统（如Windows amd64）的压缩包。
  2. 在工作目录下创建路径：.terraform/providers/registry.terraform.io/hashicorp/local/<版本号>/windows_amd64（替换<版本号>为实际版本，如2.4.0）。
  3. 将下载的压缩包解压到该路径，然后执行terraform init。

• 检查防火墙/安全软件
  临时关闭Windows防火墙或第三方安全软件，确认是否是它们阻止了Terraform访问外网。若确认，将Terraform程序加入安全软件白名单。

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