当前位置:首页 > 文章列表 > 文章 > java教程 > SpringBootJar包瘦身引发的IllegalAccessError:类加载器冲突终极解决指南

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

2025-03-06 21:00:04 0浏览 收藏

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包瘦身引发的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),同时保留addClasspathclasspathPrefix等配置,并移除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学习网公众号也会发布文章相关知识,快来关注吧!

Pythonyield关键字:深度解析协程机制Pythonyield关键字:深度解析协程机制
上一篇
Pythonyield关键字:深度解析协程机制
phpStudySSL证书配置教程:轻松实现网站HTTPS加密
下一篇
phpStudySSL证书配置教程:轻松实现网站HTTPS加密
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    542次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    511次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    498次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    484次学习
查看更多
AI推荐
  • 千音漫语:智能声音创作助手,AI配音、音视频翻译一站搞定!
    千音漫语
    千音漫语,北京熠声科技倾力打造的智能声音创作助手,提供AI配音、音视频翻译、语音识别、声音克隆等强大功能,助力有声书制作、视频创作、教育培训等领域,官网:https://qianyin123.com
    153次使用
  • MiniWork:智能高效AI工具平台,一站式工作学习效率解决方案
    MiniWork
    MiniWork是一款智能高效的AI工具平台,专为提升工作与学习效率而设计。整合文本处理、图像生成、营销策划及运营管理等多元AI工具,提供精准智能解决方案,让复杂工作简单高效。
    147次使用
  • NoCode (nocode.cn):零代码构建应用、网站、管理系统,降低开发门槛
    NoCode
    NoCode (nocode.cn)是领先的无代码开发平台,通过拖放、AI对话等简单操作,助您快速创建各类应用、网站与管理系统。无需编程知识,轻松实现个人生活、商业经营、企业管理多场景需求,大幅降低开发门槛,高效低成本。
    160次使用
  • 达医智影:阿里巴巴达摩院医疗AI影像早筛平台,CT一扫多筛癌症急慢病
    达医智影
    达医智影,阿里巴巴达摩院医疗AI创新力作。全球率先利用平扫CT实现“一扫多筛”,仅一次CT扫描即可高效识别多种癌症、急症及慢病,为疾病早期发现提供智能、精准的AI影像早筛解决方案。
    155次使用
  • 智慧芽Eureka:更懂技术创新的AI Agent平台,助力研发效率飞跃
    智慧芽Eureka
    智慧芽Eureka,专为技术创新打造的AI Agent平台。深度理解专利、研发、生物医药、材料、科创等复杂场景,通过专家级AI Agent精准执行任务,智能化工作流解放70%生产力,让您专注核心创新。
    164次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议隐私政策
返回登录
  • 重置密码