flatten-maven-plugin多模块Maven项目部署:SpringBoot可执行Jar无法启动怎么办?
核心问题排查与解决方案
你遇到的启动失败,基本是flatten插件执行顺序、spring-boot-maven-plugin多模块默认行为两个常见坑叠加导致的,逐点对应修正即可:
常见根因
- flatten插件与Spring Boot插件执行顺序冲突:flatten插件默认绑定在
process-resources阶段,会动态修改项目的有效pom元数据。如果执行顺序在spring-boot插件repackage目标之前配置错误,会把springboot给jar设置的分类器、主清单属性等元数据覆盖,导致最终打出来的可执行包结构异常。 - Spring Boot插件的多模块默认兼容逻辑误触发:Spring Boot 2.x之后的版本,会在repackage阶段自动检测当前模块是否被其他模块作为依赖引入——如果检测到了,会自动切换打包逻辑:将普通薄jar(仅包含当前模块自身类,适合作为依赖给其他模块引用)作为主产物,将带全量依赖的可执行胖jar加上
exec后缀作为附属产物。多模块构建时module2依赖module1的关系会触发这个自动逻辑,导致原本应该可执行的主jar变成了没有依赖的薄jar,直接用java -jar跑自然会报找不到主类、缺依赖的错误。 - flatten插件模式配置错误:如果没有指定flatten的运行模式,默认会生成全量解析的pom内容,甚至会覆盖springboot插件设置的artifact分类规则,导致打包产物和预期不一致。
具体修正步骤
- 补全父pom中flatten-maven-plugin的正确配置
替换原来占位的插件配置为以下内容,用CI友好的版本解析模式,避免过度修改pom结构:<plugin> <groupId>org.codehaus.mojo</groupId> <artifactId>flatten-maven-plugin</artifactId> <version>1.5.0</version> <configuration> <!-- 仅解析${revision}这类变量占位符,不修改原有pom的其他结构 --> <flattenMode>resolveCiFriendliesOnly</flattenMode> </configuration> <executions> <execution> <id>flatten-process</id> <phase>process-resources</phase> <goals> <goal>flatten</goal> </goals> </execution> <execution> <id>flatten-clean</id> <phase>clean</phase> <goals> <goal>clean</goal> </goals> </execution> </executions> </plugin> - 修正module1的spring-boot-maven-plugin配置
显式指定repackage目标的执行规则,避免被自动检测逻辑打乱产物结构,同时保持对下游module2的兼容性:
调整后module1打包完成后,target目录会生成两个jar:<plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> <executions> <execution> <id>boot-repackage</id> <goals> <goal>repackage</goal> </goals> <configuration> <!-- 固定可执行胖jar的分类器,明确区分薄依赖包和可执行包 --> <classifier>exec</classifier> </configuration> </execution> </executions> </plugin>module1-${revision}.jar:薄结构包,仅包含module1自身的类文件,作为正常依赖上传到仓库,供module2引入使用module1-${revision}-exec.jar:全量依赖的可执行包,直接用java -jar运行这个包即可正常启动
- 打包前的验证动作
执行mvn clean package完成构建后,先检查module1的target目录产物:- 解压可执行的
-exec后缀jar,确认META-INF/MANIFEST.MF中存在Main-Class: org.springframework.boot.loader.JarLauncher配置,且BOOT-INF目录下包含完整依赖 - 确认薄结构的主jar没有BOOT-INF目录,避免把全量依赖的胖jar传给下游module2,导致依赖冲突
- 解压可执行的
额外注意
如果之前打出来的jar已经存在本地仓库缓存,先执行mvn clean install -U强制刷新本地仓库的依赖缓存,避免旧的异常jar被读取。
内容的提问来源于stack exchange,提问作者zhuochen shen
相关产品推荐
相关产品推荐

