多层Module依赖项目Maven编译错误的解决方案

多层Module依赖项目Maven编译错误的解决方案

一、Maven编译错误信息

Maven编译时报错如下：

[ERROR] Failed to execute goal org.apache.maven.plugins:maven-compiler-plugin:3.14.0:compile (default-compile) on project erp-concrete: Compilation failure: Compilation failure:
[ERROR] /D:/IdeaProject/tr-erp/erp-modules/erp-concrete/src/main/java/com/tongruan/cm/base/service/impl/CmBaseChatecUtilsImpl.java:[104,63] 无法访问BaseMapperPlus
[ERROR] 找不到BaseMapperPlus的类文件
[ERROR] /D:/IdeaProject/tr-erp/erp-modules/erp-concrete/src/main/java/com/tongruan/cm/base/service/impl/CmBaseMatSpecServiceImpl.java:[216,53] 找不到符号
[ERROR] 符号: 方法 selectObjs(com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper<com.tongruan.system.domain.SysTenant>,(x)->{ ret[…]x); )
[ERROR] 位置: 类型为com.tongruan.system.mapper.SysTenantMapper的变量 sysTenantMapper
[ERROR] /D:/IdeaProject/tr-erp/erp-modules/erp-concrete/src/main/java/com/tongruan/cm/dispatch/service/impl/CmDispatchTaskReportServiceImpl.java:[2066,43] 找不到符号
[ERROR] 符号: 方法 selectById(java.lang.Long)
[ERROR] 位置: 类型为com.tongruan.system.mapper.SysDeptMapper的变量 sysDeptMapper

二、错误原因分析

2.1 错误类型

这些错误是编译时依赖找不到的问题，具体原因如下：

2.2 根本原因

通过分析，项目结构如下：

tr-erp (父POM)
├── erp-common (公共模块)
│ └── erp-common-mybatis (包含 BaseMapperPlus)
├── erp-modules
│ ├── erp-system (业务模块，依赖 erp-common-mybatis)
│ └── erp-concrete (业务模块，依赖 erp-system)

问题原因: 在执行 mvn compile 时，如果未指定 -am (also-make) 参数，Maven只会编译指定模块，不会自动编译其依赖模块。这导致：

三、解决步骤

3.1 解决方案

使用 Maven 的 -am 参数，该参数会同时编译指定模块的所有依赖模块：

mvn compile -pl erp-modules/erp-concrete -am -DskipTests

参数说明：

• -pl erp-modules/erp-concrete：指定编译 erp-concrete 模块
• -am (also-make)：同时编译指定模块的依赖模块
• -DskipTests：跳过测试以加快编译速度

3.2 验证结果

执行上述命令后，编译成功：

[INFO] BUILD SUCCESS
[INFO] ————————————————————————
[INFO] Reactor Summary for tr-erp 5.5.3:
[INFO]
[INFO] tr-erp ……………………………………… SUCCESS
[INFO] erp-common ………………………………….. SUCCESS
[INFO] erp-common-core ……………………………… SUCCESS
[INFO] erp-common-mybatis …………………………… SUCCESS
[INFO] erp-system ………………………………….. SUCCESS
[INFO] erp-concrete ………………………………… SUCCESS
[INFO] ————————————————————————

四、总结

4.1 问题本质

这不是代码错误，而是Maven模块依赖编译顺序问题。当一个模块依赖另一个模块时，需要确保依赖模块先被编译。

4.2 单独编译某个模块

核心问题：当一个模块依赖另一个模块时，需要确保依赖模块先被编译或安装到本地仓库。

编译 erp-concrete 模块（包含依赖）

方案一：使用 -am 参数（同时编译依赖模块）

mvn clean compile -pl erp-modules/erp-concrete -am -DskipTests

参数说明：

• -pl: 指定要编译的模块 (project list)
• -am: 同时编译指定模块的依赖模块 (also-make)
• -DskipTests: 跳过测试

方案二：先安装依赖模块，再编译目标模块（推荐）

# 第一步：先安装 erp-system 及其依赖到本地仓库
mvn install -pl erp-modules/erp-system -am -DskipTests

# 第二步：编译 erp-concrete（此时依赖已在本地仓库）
mvn compile -pl erp-modules/erp-concrete -DskipTests

编译 erp-system 模块（包含依赖）

mvn clean compile -pl erp-modules/erp-system -am -DskipTests

4.3 常用打包命令

4.4 最佳实践

4.5 验证状态

五、后续建议

如果后续仍然遇到类似的编译问题，可以尝试：

关键点