多模块Spring Boot项目引入utils-module依赖失败问题咨询

以下是导致该问题的常见原因及分析：

• utils-module未安装到本地Maven仓库
  Maven解析同项目内的模块依赖时，需要目标模块先通过mvn install命令安装到本地仓库（默认路径~/.m2/repository）。如果仅执行compile或package，utils-module的构建产物只会留在项目目录，不会被Maven的依赖解析机制识别，此时ingestion-service构建时会自动转向远程仓库（如Artifactory）查找，自然无法找到未发布的本地模块。

• 依赖坐标不匹配
  检查ingestion-service的pom.xml中utils-module的依赖坐标（groupId、artifactId、version），必须与utils-module自身pom.xml中的对应字段完全一致。哪怕是大小写、版本号的细微差异，都会让Maven认为这是一个外部依赖，进而尝试从远程仓库拉取。

• 父模块与子模块的关系未正确配置
  若父pom的<modules>标签未包含utils-module，或者ingestion-service的pom未通过<parent>标签正确继承父pom，Maven不会将它们视为同一多模块项目的组成部分，依然会按外部依赖处理，去远程仓库查找。调整模块顺序无法解决这种配置缺失的问题。

• Maven Reactor构建顺序未按依赖关系执行
  Maven Reactor会根据模块间的依赖关系自动决定构建顺序，而非仅遵循父pom中<modules>的排列顺序。如果ingestion-service的pom中声明了utils-module依赖，但utils-module的pom未反向声明相关依赖（或依赖关系不明确），Reactor可能先构建ingestion-service，此时utils-module尚未完成构建和安装，导致依赖解析失败。单纯调整模块顺序无法修正这种依赖关系不明确的问题。

• 本地Maven仓库缓存损坏
  若本地仓库中utils-module的缓存文件存在损坏、不完整，或者之前构建失败留下了错误记录，Maven可能会跳过本地模块的查找，直接尝试从远程仓库下载。解决方法是删除~/.m2/repository中对应utils-module的目录，然后重新执行mvn clean install。

• Maven配置覆盖了本地模块识别
  检查Maven的settings.xml配置，如果设置了优先级过高的镜像仓库，或者IDE中配置了自定义的Maven仓库路径，可能导致Maven优先从远程仓库查找依赖，忽略本地的多模块项目模块。确保配置中未屏蔽本地仓库的优先级。

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