Terraform init自动化脚本执行失败，如何修复？

1. 严格对齐本地Provider的目录结构 #

Terraform对本地插件路径有强制要求，必须遵循以下层级：
terraform.d/plugins/<registry域名>/<厂商命名空间>/<Provider类型>/<版本号>/<系统_架构>
比如你用AWS Provider 5.0.0（Linux amd64），路径必须是：
terraform.d/plugins/registry.terraform.io/hashicorp/aws/5.0.0/linux_amd64/terraform-provider-aws_v5.0.0_x5
脚本里复制二进制文件时，必须先创建好这个完整路径，不能直接把文件丢在插件根目录。

2. 修正terraformrc配置（彻底禁用远程查询） #

不要混用多种安装配置，直接用以下配置完全强制本地镜像，避免Terraform偷偷查注册表：

provider_installation {
  filesystem_mirror {
    path    = "./terraform.d/plugins"
    include = ["registry.terraform.io/*/*"]
  }
  direct {
    exclude = ["registry.terraform.io/*/*"]
  }
}

注意：脚本生成该文件时，优先放在Terraform工作目录下命名为.terraformrc（当前目录配置优先级高于全局），Linux/macOS全局路径是~/.terraformrc，Windows是%APPDATA%\terraform.rc。

3. 强制Provider版本与本地二进制完全匹配 #

在你的main.tf里必须明确指定和本地二进制一致的版本号，不能用版本范围：

terraform {
  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = "5.0.0" # 必须和本地二进制版本丝毫不差
    }
  }
}

脚本可以自动替换main.tf里的版本字段，确保和复制的二进制版本对齐。

4. 脚本执行的权限与环境处理 #

• 复制二进制后，给文件添加执行权限：chmod +x ./terraform.d/plugins/.../terraform-provider-*（仅Linux/macOS）
• 执行terraform init前，切换到Terraform配置文件所在的工作目录
• 可选添加export TF_LOG=DEBUG到脚本，方便查看初始化时的详细报错日志

完整示例脚本（Linux/macOS） #

#!/bin/bash

# 自定义参数
PROVIDER_NAMESPACE="hashicorp"
PROVIDER_TYPE="aws"
PROVIDER_VERSION="5.0.0"
OS_ARCH="linux_amd64"
# 本地Provider二进制文件的路径
LOCAL_PROVIDER_BIN="/home/you/downloads/terraform-provider-aws_v5.0.0_x5"
# Terraform工作目录
TF_WORK_DIR="./tf-auto-init"

# 创建工作目录
mkdir -p "${TF_WORK_DIR}"

# 创建合规的插件目录结构
PLUGIN_TARGET_DIR="${TF_WORK_DIR}/terraform.d/plugins/registry.terraform.io/${PROVIDER_NAMESPACE}/${PROVIDER_TYPE}/${PROVIDER_VERSION}/${OS_ARCH}"
mkdir -p "${PLUGIN_TARGET_DIR}"

# 复制二进制并添加执行权限
cp "${LOCAL_PROVIDER_BIN}" "${PLUGIN_TARGET_DIR}/"
chmod +x "${PLUGIN_TARGET_DIR}/terraform-provider-*"

# 生成当前目录的.terraformrc
cat > "${TF_WORK_DIR}/.terraformrc" << EOF
provider_installation {
  filesystem_mirror {
    path    = "./terraform.d/plugins"
    include = ["registry.terraform.io/*/*"]
  }
  direct {
    exclude = ["registry.terraform.io/*/*"]
  }
}
EOF

# 生成带指定版本的main.tf
cat > "${TF_WORK_DIR}/main.tf" << EOF
terraform {
  required_providers {
    ${PROVIDER_TYPE} = {
      source  = "${PROVIDER_NAMESPACE}/${PROVIDER_TYPE}"
      version = "${PROVIDER_VERSION}"
    }
  }
}

provider "${PROVIDER_TYPE}" {
  # 按需添加你的Provider配置
}
EOF

# 切换到工作目录执行init
cd "${TF_WORK_DIR}"
# 可选开启调试日志
# export TF_LOG=DEBUG
terraform init

常见排查点 #

• 检查本地二进制文件名是否符合规范：terraform-provider-<类型>_<版本>_<系统>_<架构>
• 执行terraform providers mirror ./terraform.d/plugins可以自动生成合规的目录结构（可用来验证路径是否正确）
• 确认terraformrc里的path是相对工作目录的路径，或者用绝对路径避免歧义

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