CircleCI中Terraform destroy报错模块未安装，求助解决

你的问题核心是同一个Job内执行terraform/destroy时，Terraform无法找到已安装的模块，即使重复执行init也无效。以下是针对性的排查方向和修复方案：

1. 工作目录不匹配（最常见原因） #

如果你的Terraform配置文件不在项目根目录（比如放在terraform/子文件夹下），CircleCI的Terraform Orb步骤默认会在项目根目录执行操作，导致destroy步骤找不到之前init时下载的模块。

修复方案：给所有Terraform步骤指定正确的工作目录：

version: 2.1
orbs:
  terraform: circleci/terraform@3.1
jobs:
  deploy_infrastructure:
    executor: terraform/default
    steps:
      - checkout
      # 为每个Terraform步骤添加working_directory参数
      - terraform/init:
          working_directory: ./terraform # 替换为你的TF配置实际路径
      - terraform/validate:
          working_directory: ./terraform
      - terraform/plan:
          working_directory: ./terraform
      - terraform/apply:
          working_directory: ./terraform
          approve: true # 自动确认apply，避免CI卡住
      - terraform/destroy:
          working_directory: ./terraform
          approve: true # 自动确认destroy
workflows:
  deploy_infrastructure:
    jobs:
      - deploy_infrastructure

2. 模块缓存丢失 #

虽然同一个Job默认共享工作目录，但极端情况下（比如网络波动、磁盘清理）可能导致.terraform目录被意外清除。通过缓存模块目录可彻底避免这个问题：

修复方案：添加缓存步骤复用已下载的模块：

jobs:
  deploy_infrastructure:
    executor: terraform/default
    steps:
      - checkout
      # 恢复之前缓存的模块
      - restore_cache:
          keys:
            - terraform-modules-{{ checksum "main.tf" }} # 用TF配置文件的校验和作为缓存键
            - terraform-modules- # 降级缓存键，匹配任意terraform-modules开头的缓存
      - terraform/init
      # 缓存下载好的模块
      - save_cache:
          paths:
            - .terraform
          key: terraform-modules-{{ checksum "main.tf" }}
      - terraform/validate
      - terraform/plan
      - terraform/apply:
          approve: true
      - terraform/destroy:
          approve: true

3. Terraform Orb版本兼容性问题 #

你使用的circleci/terraform@3.1属于较旧版本，可能存在步骤间的状态传递bug。

修复方案：升级到最新稳定版本（比如circleci/terraform@4.2）：

orbs:
  terraform: circleci/terraform@4.2 # 替换为当前最新版本

4. 私有模块认证失效 #

如果你的模块来自私有Git仓库或私有Terraform Registry，init步骤需要认证信息才能下载模块。若后续步骤中认证信息丢失，即使重新执行init也会失败。

排查方向：

• 检查CircleCI是否配置了正确的SSH密钥或环境变量（比如TF_TOKEN）；
• 查看terraform/init步骤的完整日志，确认模块下载过程中是否有认证错误。

快速排查步骤 #

1. 查看terraform/init步骤的日志，确认模块是否成功下载到.terraform/modules目录；
2. 在apply步骤后添加临时命令ls -la .terraform/modules，检查模块文件是否存在；
3. 确认所有Terraform步骤的工作路径完全一致。

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