Terraform引用私有Git模块时状态导入失败、资源检测异常

模块引用配置不符合Terraform Git源的加载规则，属于对模块机制的理解偏差：

• 当source字段仅填写Git仓库根地址时，Terraform默认会将仓库根目录作为模块根目录加载，不会自动递归查找子目录下的tf配置文件。你当前的模块实际存放在仓库的mymodule子目录下，Terraform拉取时拿到的是包含readme的根目录内容，根本没有加载到你定义的Lambda、EventBridge、S3相关资源块，自然无法识别已部署的资源，直接导致状态导入失败。

1. 修改业务项目中main.tf的模块引用配置，通过//显式指定仓库内的模块子目录路径：

module "mymodule" {
  source = "git::https://github.com/myprivaterepo/tf-modules.git//mymodule"
}

如果需要固定拉取特定分支、标签的模块版本，可以在路径后追加ref参数，例如固定拉取v1.2.0标签的版本：

module "mymodule" {
  source = "git::https://github.com/myprivaterepo/tf-modules.git//mymodule?ref=v1.2.0"
}

2. 在业务项目对应目录（即CUSTNAME/mymodule路径下）执行命令重新初始化，拉取正确路径的模块、覆盖之前错误的缓存：

terraform init -upgrade

3. 验证模块加载结果：打开本地.terraform/modules/mymodule目录，能直接看到lambda.tf、eventbridge.tf、bucket.tf三个配置文件、没有根目录的readme等无关文件，就说明模块加载正常，后续执行状态导入、plan/apply操作都可以正常识别对应资源。

• 单仓库存放多个可复用模块是Terraform的常规用法，后续你在tf-modules仓库新增其他模块（比如网络模块、数据库模块）时，只需要在引用时把//后的子目录路径换成对应模块的目录名即可，不需要为每个模块单独创建代码仓库。
• 状态导入操作需要明确指定资源在模块内的完整地址，导入前可以先执行terraform plan确认Terraform列出的待创建资源和你已部署的资源一一对应，再执行import操作避免地址写错。

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