Terragrunt+AWS CodeBuild共享插件目录报错求助：无法安装现有目录到自身

问题概述 #

在AWS CodeBuild中按顺序运行存在依赖关系的Terragrunt模块（module-a、module-b、module-v），为避免重复下载Terraform插件占用磁盘空间，设置统一插件目录/root/.terraform.d/plugins并在buildspec.yaml中配置缓存，但运行时触发以下类型报错：

│ Error: Failed to install provider
│ 
│ Error while installing gavinbunney/kubectl v1.14.0: cannot install existing
│ provider directory
│ /root/.terraform.d/plugins/registry.terraform.io/gavinbunney/kubectl/1.14.0/linux_amd64
│ to itself

同时更换插件目录后，Terragrunt未正确使用新目录。使用版本：Terraform v1.5.0、Terragrunt v0.47.0。

报错原因 #

1. Terraform 1.5+的provider自动安装逻辑会检测目标路径是否已存在完整的provider目录，若缓存目录直接使用Terraform默认的插件存放路径，会触发“禁止将目录安装到自身”的保护机制。
2. Terragrunt未正确读取自定义插件目录，通常是环境变量传递不彻底或Terragrunt配置优先级导致。

解决方案 #

1. 调整插件缓存目录路径 #

将TF_PLUGIN_CACHE_DIR设置为Terraform默认插件目录的子目录，避免路径冲突：

export TF_PLUGIN_CACHE_DIR=/root/.terraform.d/cache/plugins

2. 修正buildspec.yaml缓存配置 #

更新缓存路径为新的插件目录，简化配置避免冗余：

cache:
  paths:
    - /root/.terraform.d/cache/plugins/**/*

3. 确保Terragrunt继承环境变量 #

在buildspec.yaml的env区块显式声明环境变量，保证所有步骤都能读取：

env:
  variables:
    TF_PLUGIN_CACHE_DIR: "/root/.terraform.d/cache/plugins"

或者在Terragrunt配置文件terragrunt.hcl中强制指定插件目录，覆盖默认行为：

terraform {
  extra_arguments "plugin_cache" {
    commands = get_terraform_commands_that_need_vars()
    arguments = [
      "-plugin-dir=${get_env("TF_PLUGIN_CACHE_DIR", "/root/.terraform.d/cache/plugins")}"
    ]
  }
}

4. 预处理缓存目录（可选） #

若之前缓存了旧路径的插件，可在build开始前迁移到新目录，避免重新下载：

mkdir -p /root/.terraform.d/cache/plugins
cp -r /root/.terraform.d/plugins/registry.terraform.io/* /root/.terraform.d/cache/plugins/ || true

验证 #

• 第一个模块运行时，Terraform会将插件下载到指定缓存目录
• 后续模块运行时，直接读取缓存中的插件，无重复下载行为
• 查看CodeBuild缓存日志，确认插件目录被正确缓存和恢复

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