SpringBootJar包瘦身引发的IllegalAccessError：类加载器冲突终极解决指南

Spring Boot Jar包瘦身后，开发者常遇到`IllegalAccessError`错误，本文分析了此类错误由类加载器冲突导致的原因。一个Spring Boot应用在瘦身后，启动时报错`java.lang.IllegalAccessError`，其原因并非`MANIFEST.MF`的`Class-Path`配置错误，而是缺少Spring Boot Maven Plugin，导致Maven Jar Plugin无法正确处理类加载器。文章指出，解决方法是完善Maven Jar Plugin配置，正确设置主类、输出目录等，并保留相关配置，最终避免类加载器冲突，从而解决`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命令启动时报错：

<code>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]
    ...</code>

该错误表明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问题。

终于介绍完啦！小伙伴们，这篇关于《SpringBootJar包瘦身引发的IllegalAccessError：类加载器冲突终极解决指南》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！