Spring Boot Jar包瘦身后出现IllegalAccessError:如何排查并解决类加载器冲突?

Spring Boot Jar包瘦身后出现IllegalAccessError:如何排查并解决类加载器冲突?

spring Boot Jar包瘦身引发的IllegalAccessError:类加载器冲突排查与修复

为减小spring boot应用的Jar包体积,开发者常采用Jar包瘦身策略,将依赖库移至Jar包外部。然而,此操作可能导致意想不到的IllegalAccessError错误,本文将详细分析此问题。

问题描述:

一个Spring Boot应用(版本2.3.2.RELEASE,spring cloud版本Hoxton.SR9,Spring Cloud Alibaba版本2.2.6.RELEASE)在瘦身操作后,使用Java -jar命令启动时报错:

Caused by: java.lang.IllegalAccessError: class org.springframework.cloud.openfeign.hystrixtargeter$$EnhancerBySpringCGLIB$$7e887a8a cannot access its superclass org.springframework.cloud.openfeign.hystrixtargeter     at java.lang.ClassLoader.defineClass1(Native Method) ~[na:1.8.0_333]     ...

该错误表明Spring CGLIB生成的代理类org.springframework.cloud.openfeign.hystrixtargeter$$EnhancerBySpringCGLIB$$7e887a8a无法访问其父类,通常由类加载器冲突引起。开发者尝试自定义BeanPostProcessor调整类加载器,但问题依旧存在。瘦身策略是使用maven Dependency Plugin将依赖库复制到Jar包外部的lib目录,并在MANIFEST.MF文件中添加指向该目录的Class-Path。

问题根源分析:

虽然开发者怀疑MANIFEST.MF中的Class-Path配置导致类加载器不一致,但根本原因在于缺少Spring Boot Maven Plugin以及Maven Jar Plugin配置不完整。 Spring Boot Maven Plugin在打包时会自动处理类加载器问题,确保应用正常运行。瘦身操作中移除该插件,仅依赖Maven Jar Plugin和Maven Dependency Plugin,导致问题出现。Maven Jar Plugin能创建Jar包并设置Class-Path,但缺乏Spring Boot的类加载器管理机制,从而引发IllegalAccessError。

解决方案:

通过完善Maven Jar Plugin配置解决此问题。关键在于正确配置主类(mainClass)和输出目录(outputDirectory),同时保留addClasspath、classpathPrefix等配置,并移除Spring Boot Maven Plugin。完整的Maven Jar Plugin配置如下:

<plugin>     <groupId>org.apache.maven.plugins</groupId>     <artifactId>maven-jar-plugin</artifactId>     <configuration>         <archive>             <manifest>                 <addClasspath>true</addClasspath>                 <classpathPrefix>lib/</classpathPrefix>                 <useUniqueVersions>false</useUniqueVersions>                 <mainClass>com.bdip.cost.CostApplication</mainClass>             </manifest>         </archive>         <outputDirectory>${boot-jar-output}</outputDirectory>     </configuration> </plugin>

此配置确保Maven Jar Plugin正确设置主类和输出目录,Maven Dependency Plugin继续负责将依赖库复制到lib目录,避免类加载器冲突,从而解决IllegalAccessError问题。

© 版权声明
THE END
喜欢就支持一下吧
点赞9 分享