多模块Maven项目中公共依赖模块引发主类找不到错误排查

结合你描述的现象和多模块Maven项目的常见问题，核心原因大概率集中在以下几个方面：

1. Maven模块构建顺序配置错误 #

• 父POM的<modules>列表中，common模块的位置在依赖它的业务模块（如order_service）之后。Maven命令行执行clean install时，会严格按照<modules>的顺序依次构建模块。如果先构建依赖common的模块，此时common还未编译安装到本地仓库，自然会出现找不到类的编译错误。
• IDE（如IntelliJ IDEA）会自动分析模块间的依赖关系，自动调整构建顺序，所以IDE内运行正常，但命令行构建会暴露顺序问题。后续IDE出现的首个模块主类找不到的问题，也是因为Maven构建后破坏了IDE的依赖缓存，而模块顺序调整后，新的首个模块会因同样的顺序问题触发错误。

2. Common模块的依赖配置异常 #

• 子模块依赖common时，可能存在坐标（groupId/artifactId/version）不匹配的情况，或者错误使用了provided等不适合的依赖范围，导致Maven编译时无法正确引入common的编译产物。
• 另外，如果common模块的POM中未正确指定打包类型（默认是jar，但如果被修改为pom或其他类型），会导致该模块无法生成可被依赖的class文件，进而引发依赖它的模块编译失败。

3. IDE与Maven的构建缓存冲突 #

• 当你用Maven命令行执行clean install后，Maven会清理并重新生成模块的target目录，但IDE可能未及时同步这些变更，导致IDE的依赖索引与实际编译产物不一致，出现主类找不到的错误。
• 临时修改包名能恢复IDE运行，是因为修改包名会触发IDE重新索引该模块的类路径，暂时修复了缓存不一致的问题，但再次执行Maven构建后，缓存冲突会再次出现。

4. 本地Maven仓库缓存损坏 #

• common模块的编译产物可能未正确安装到本地仓库，或者本地仓库中的common包出现损坏。这种情况下，依赖它的模块在编译时无法从本地仓库获取正确的class文件，导致编译错误。

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