You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Spring Boot2.7升级后repackage打包重复类启动报错如何解决

问题原因

Spring Boot 2.7.0版本对spring-boot-maven-plugin做了模块结构调整,原本内置在插件中的org.springframework.boot.loader启动类加载器相关代码,被拆分到了独立的spring-boot-loader模块。
你将repackage打包逻辑完全配置在Maven profile中的写法,会打乱插件默认的执行顺序:maven-jar-plugin先执行普通jar打包时,会把插件传递引入、错误出现在项目编译输出目录的loader类,全部打进原始jar包的类路径下;后续执行repackage操作时,没有识别到这些loader类本该放在jar包根目录作为启动引导类,也没有做路径过滤,最终导致BOOT-INF/classes目录和jar根目录出现完全重复的loader类,触发类加载冲突,启动时抛出InvocationTargetException异常。

修复方案

两种方案选其一即可解决问题:

  • 方案1:将spring-boot-maven-plugin的基础声明移到pom.xml的全局<build><plugins>配置段,仅把需要差异化配置的<classifier>等参数留在对应profile中覆盖。这种写法能让Maven正确识别插件的执行顺序,repackage阶段会自动过滤掉不该出现在classes目录下的loader类。
    全局插件配置示例:
    <build>
      <plugins>
        <plugin>
          <groupId>org.springframework.boot</groupId>
          <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
      </plugins>
    </build>
    
    profile内仅保留差异化配置:
    <profile>
      <id>profileName</id>
      <build>
        <plugins>
          <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <executions>
              <execution>
                <id>repackage</id>
                <configuration>
                  <classifier>someName</classifier>
                </configuration>
              </execution>
            </executions>
          </plugin>
        </plugins>
      </build>
    </profile>
    
  • 方案2:如果需要把插件配置全部放在profile内,需要显式给repackage执行目标绑定package生命周期阶段,同时将spring-boot-loader依赖设为provided级别,避免它的类被输出到项目编译产物目录:
    <profile>
      <id>profileName</id>
      <build>
        <plugins>
          <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <executions>
              <execution>
                <id>repackage</id>
                <phase>package</phase>
                <goals>
                  <goal>repackage</goal>
                </goals>
                <configuration>
                  <classifier>someName</classifier>
                </configuration>
              </execution>
            </executions>
            <dependencies>
              <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-loader</artifactId>
                <scope>provided</scope>
              </dependency>
            </dependencies>
          </plugin>
        </plugins>
      </build>
    </profile>
    
验证方法

修复后重新执行对应profile的构建命令,通过jar tvf 生成的jar包文件名检查包结构,确认BOOT-INF/classes路径下不存在org/springframework/boot/loader目录即可。此时jar包的类加载逻辑恢复正常,不会再抛出启动异常。

内容的提问来源于stack exchange,提问作者covfefe

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.27 20:12:26