Terraform模块路径错误：无法读取pubsubTopicCreationModule模块

核心问题分析 #

Terraform模块的source路径是相对于当前配置文件（dev_main.tf）所在目录的相对路径，错误提示找不到../../modules，说明当前文件所在目录往上两级不存在modules文件夹，或路径拼写/大小写有误（Linux/macOS系统区分文件名大小写）。

快速排查与修正步骤 #

1. 验证路径有效性
   打开终端，切换到dev_main.tf所在目录，执行对应系统的命令检查路径：

   • Linux/macOS：ls ../../modules/pubsubTopicCreation
   • Windows：dir ..\..\modules\pubsubTopicCreation
     如果命令返回“不存在”，则调整../的数量，比如当前文件只需要往上一级就能到根目录，就把source改成../modules/pubsubTopicCreation。

2. 使用绝对路径兜底
   若相对路径调试麻烦，可直接使用绝对路径（适合本地开发）：

   • Linux/macOS：

     module "pub_sub_topic_creation" {
       count  = length(var.pub_sub_topic_names)
       source = "/home/your-user/project-root/modules/pubsubTopicCreation"
       name   = element(var.pub_sub_topic_names, count.index)
     }
     

   • Windows：

     module "pub_sub_topic_creation" {
       count  = length(var.pub_sub_topic_names)
       source = "C:\\Users\\your-user\\project-root\\modules\\pubsubTopicCreation"
       name   = element(var.pub_sub_topic_names, count.index)
     }
     

3. 检查模块文件夹命名
   确认modules下的模块文件夹名确实是pubsubTopicCreation，避免拼写错误（比如少写字母、大小写不一致）。

常见目录结构示例 #

如果你的项目目录是如下结构：

project-root/
├── modules/
│   └── pubsubTopicCreation/
│       ├── main.tf
│       └── variables.tf
└── environments/
    └── dev/
        └── dev_main.tf

那么dev_main.tf中的source = "../../modules/pubsubTopicCreation"是正确的，此时报错大概率是文件名大小写问题或终端当前目录不对。

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