Maven多模块编译后本地包不存在问题求助

问题详情 #

我正在开发一个基于Spring Boot的个人理财管理项目，原本为单模块结构。近期将业务逻辑拆分至独立Maven模块后，执行mvn clean install或mvn package等命令时，某子模块编译报错，核心提示如下：

• package pl.intelligent.finance.persistence.entity does not exist
• cannot find symbol

相关背景：

• IDE中无任何错误提示
• 依赖已设置为默认编译级别（也尝试过其他版本）
• 该包在单模块阶段可正常编译
• 已查阅StackOverflow等平台大量帖子，仍未找到可行解决方案，请勿标记为重复问题

完整项目代码在仓库的mm_structure分支，恳请帮忙排查解决！

排查与解决建议 #

1. 核对模块依赖配置

   • 确认报错子模块的pom.xml中，是否正确引入了包含pl.intelligent.finance.persistence.entity包的模块，依赖范围需为compile（默认值），避免使用provided这类不参与编译的范围。
   • 检查提供实体类的模块pom.xml，确保<packaging>为jar，且spring-boot-maven-plugin未启用repackage（该操作会修改Jar结构，导致其他模块无法依赖编译后的类）。

2. 确认Maven编译顺序

   • 执行mvn clean install -X查看详细编译日志，确认实体类所在模块是否在报错模块之前完成编译并安装到本地仓库。若顺序异常，需在父pom.xml的<modules>标签中明确指定编译顺序，或调整模块间的依赖关系。

3. 检查实体类模块的编译产物

   • 进入实体类所在模块，执行mvn clean compile，查看target/classes目录下是否存在pl/intelligent/finance/persistence/entity对应的.class文件。若不存在，需排查该模块代码的语法错误（IDE可能未检测到），或pom.xml中编译插件的配置是否正常。

4. 清理Maven本地缓存

   • 删除本地仓库中相关模块的缓存目录（默认路径为~/.m2/repository/pl/intelligent/finance），重新执行mvn clean install，避免缓存的旧产物导致依赖异常。

5. 同步IDE与Maven配置

   • 确保IDE使用的Maven版本与命令行一致，且IDE的JDK版本、编译级别等配置与pom.xml完全匹配。可尝试在IDE中直接执行Maven命令，对比报错信息是否一致，排查IDE配置差异问题。

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