You need to enable JavaScript to run this app. flatten-maven-plugin多模块Maven项目部署:SpringBoot可执行Jar无法启动怎么办?
优惠活动
大模型
产品
解决方案
定价
更多

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分类规则,导致打包产物和预期不一致。

具体修正步骤

  1. 补全父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>
    
  2. 修正module1的spring-boot-maven-plugin配置
    显式指定repackage目标的执行规则,避免被自动检测逻辑打乱产物结构,同时保持对下游module2的兼容性:
    <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打包完成后,target目录会生成两个jar:
    • module1-${revision}.jar:薄结构包,仅包含module1自身的类文件,作为正常依赖上传到仓库,供module2引入使用
    • module1-${revision}-exec.jar:全量依赖的可执行包,直接用java -jar运行这个包即可正常启动
  3. 打包前的验证动作
    执行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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.14 16:15:04