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类。
全局插件配置示例:
profile内仅保留差异化配置:<build> <plugins> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> </plugin> </plugins> </build><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
相关产品推荐
相关产品推荐

