Terraform本地模块定位失败求助：未知原因

报错信息 #

#Warning:(7, 1) Cannot locate module locally: Unknown reason

模块调用代码（env_prod/main.tf） #

# 模块调用代码位于env_prod目录下的main.tf
module "az_resource_groups" {
  source="../module/az_resource_groups"
  context_object  = local.context_object 
  resource_groups = var.resource_groups  
  tags            = var.tags
}

排查步骤 #

• 核对路径拼写与大小写：确认../module/az_resource_groups路径无拼写错误，注意Linux/macOS系统区分目录名大小写，Windows不区分，需保证模块目录名完全匹配。
• 验证模块目录结构：从env_prod目录向上一级，确认存在module文件夹，且该文件夹下有az_resource_groups子目录；同时az_resource_groups目录内必须包含至少一个.tf后缀的文件（比如main.tf），否则Terraform无法识别为有效模块。
• 检查文件权限：确保当前执行Terraform的用户对模块目录及内部文件拥有读取权限，避免因权限不足导致无法访问模块。
• 重置Terraform缓存：执行terraform init -reconfigure命令，强制重新初始化并刷新模块缓存，解决缓存异常引发的路径识别问题。
• 测试绝对路径：临时将source替换为模块的绝对路径（如/home/user/terraform/module/az_resource_groups或C:\terraform\module\az_resource_groups），若能正常识别，说明相对路径解析异常——需确认执行Terraform命令时的工作目录是env_prod。

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