如何将Maven多模块项目中的一个模块迁移至独立目录？

你遇到的核心问题是Maven本地仓库需要严格遵循groupId/artifactId/version的目录结构，直接把JAR扔到repo根目录是无法被识别的。按以下步骤调整：

1. 整理本地仓库目录结构 #

• 找到原项目中依赖模块的完整坐标（groupId、artifactId、version），比如原模块坐标为com.example:common-module:2.0.0
• 在新项目的./repo下创建层级目录：./repo/com/example/common-module/2.0.0
• 将原项目打包生成的common-module-2.0.0.jar，以及该模块的pom.xml（重命名为common-module-2.0.0.pom）一起放入这个目录

2. 修正本地仓库URL配置 #

根据操作系统调整仓库URL：

• Windows系统：使用三个斜杠，配置如下：

<repositories>
  <repository>
    <id>data-local</id>
    <name>data</name>
    <url>file:///${project.basedir}/repo</url>
  </repository>
</repositories>

• Linux/macOS系统：使用两个斜杠即可，保持你当前的配置即可，或者统一用file:${project.basedir}/repo（跨平台兼容）

3. 强制更新依赖 #

执行Maven命令强制刷新依赖缓存：

mvn clean install -U

额外排查点 #

• 确认新项目子模块的pom.xml中，依赖的坐标（groupId、artifactId、version）和原模块完全一致，包括大小写、SNAPSHOT标识
• 若依赖是SNAPSHOT版本，确保JAR文件名包含SNAPSHOT，且仓库目录结构对应
• 执行mvn dependency:tree -Dverbose查看依赖解析日志，定位具体无法找到的依赖项

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