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命令启动时报错：

<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。

问题根源分析：

Blackink AI纹身生成

创建类似纹身的设计，生成独特纹身

17

查看详情

虽然开发者怀疑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问题。

以上就是Spring Boot Jar包瘦身后出现IllegalAccessError：如何排查并解决类加载器冲突？的详细内容，更多请关注php中文网其它相关文章！