为何每次执行Terraform Plan/Apply都会自动运行Init？

可能触发重复初始化的原因 #

• 本地 .terraform 缓存目录或 .terraform.lock.hcl 锁文件丢失/损坏
• Azure 存储账户远程状态的访问凭证（如 SAS 令牌、账户密钥）过期或变更
• Terraform 后端配置与当前环境不匹配，导致每次命令都需要重新验证连接

调试步骤 #

1. 检查本地缓存状态
   • 确认项目根目录下存在 .terraform 文件夹和 .terraform.lock.hcl 文件，若缺失则会触发自动初始化
   • 执行 terraform init -reconfigure 强制重新生成本地配置缓存，之后运行 terraform plan 测试是否仍会重复初始化
2. 验证 Azure 存储账户访问权限
   • 检查 backend.tf 中的配置参数（存储账户名、容器名、连接字符串/密钥）是否正确
   • 使用 Azure CLI 测试访问：az storage blob list --container-name <你的容器名> --account-name <你的存储账户名>，确保能正常列出状态文件
3. 启用调试日志定位问题
   • 运行带调试日志的命令：TF_LOG=DEBUG terraform plan，查看日志中关于「Initializing the backend」的详细输出，找到触发重复初始化的具体触发点
4. 确认依赖锁文件有效性
   • 检查 .terraform.lock.hcl 文件是否被篡改或缺失，该文件用于锁定提供商版本，缺失会导致每次重新下载提供商

解决方法 #

• 重新初始化并固化配置：执行 terraform init -upgrade，该命令会更新提供商版本、重新生成本地缓存并同步后端配置，完成后后续命令应不再重复初始化
• 更新后端访问凭证：若 SAS 令牌或账户密钥过期，更新 backend.tf 中的对应配置，或切换为 Azure AD 身份验证（更安全且无需频繁轮换密钥）
• 保护本地缓存文件：确保 .terraform 目录和 .terraform.lock.hcl 文件不被误删（避免加入 .gitignore 或被清理工具删除）

执行示例 #

myhost$ terraform plan

Initializing the backend...

Initializing provider plugins...
- Reusing previous version of hashicorp/azuread from the dependency lock file
- Reusing previous version of hashicorp/random from the dependency lock file
- Reusing previous version of azure/azapi from the dependency lock file
- Reusing previous version of hashicorp/azurerm from the dependency lock file
- Using previously-installed hashicorp/azuread v2.26.1
- Using previously-installed hashicorp/random v3.1.3
- Using previously-installed azure/azapi v0.4.0
- Using previously-installed hashicorp/azurerm v3.14.0

Terraform has been successfully initialized!

版本信息 #

Terraform v1.2.4
on windows_amd64
+ provider registry.terraform.io/azure/azapi v0.4.0
+ provider registry.terraform.io/hashicorp/azuread v2.26.1
+ provider registry.terraform.io/hashicorp/azurerm v3.14.0
+ provider registry.terraform.io/hashicorp/random v3.1.3

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