Terraform与Python目录检测结果不一致问题求助

环境与问题详情 #

• 系统：Ubuntu 24.04
• Terraform版本：Terraform v1.10.3 on linux_amd64
• main.tf配置：

terraform {
  required_providers {
    flowtrends = {
      source  = "local/flowtrends"
      version = "1.0.0"
    }
  }
}
 
provider "flowtrends" {}

• 目录检测：用Python脚本确认~/.terraform.d/plugins存在，但执行terraform init时却报错该目录不存在
• 当前.terraformrc配置：

provider_installation {
  filesystem_mirror {
    path = "~/.terraform.d/plugins"
  }
}

• 额外问题：尝试改用绝对路径时，Terraform会转向官方registry搜索，而非仅本地查找

解决步骤 #

1. 修正.terraformrc的路径与搜索规则 #

Terraform对~的路径解析逻辑和Python不一致，直接用绝对路径替换，同时添加规则禁用registry搜索：

provider_installation {
  filesystem_mirror {
    # 替换成你的实际用户目录，比如/home/daan/.terraform.d/plugins
    path = "/home/你的用户名/.terraform.d/plugins"
  }
  # 强制仅从本地镜像获取插件，禁止访问官方registry
  direct {
    exclude = ["*/*/*"]
  }
}

2. 确保本地插件目录结构合规 #

Terraform要求本地插件必须放在固定层级的目录中，结构如下：

~/.terraform.d/plugins/
└── local/
    └── flowtrends/
        └── 1.0.0/
            └── linux_amd64/
                └── terraform-provider-flowtrends_v1.0.0

• 路径格式：{镜像路径}/{命名空间}/{插件名}/{版本号}/{系统架构}/terraform-provider-{插件名}_v{版本号}
• 注意：插件二进制文件名必须包含v前缀的版本号，否则Terraform无法识别

3. 清理缓存并重新初始化 #

执行以下命令清空本地缓存，再重新运行初始化：

rm -rf .terraform .terraform.lock.hcl
terraform init

4. 检查目录权限 #

确保插件目录及文件对当前用户有可读可执行权限：

chmod -R 755 ~/.terraform.d/plugins

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