0

0

详解ClassNotFoundException与NoClassDefFoundError的区别

P粉602998670

P粉602998670

发布时间:2026-02-15 08:56:03

|

831人浏览过

|

来源于php中文网

原创

classnotfoundexception是受检异常,发生在显式加载类(如class.forname)时classpath中找不到字节码;noclassdeffounderror是非受检错误,发生在jvm隐式使用类时其定义缺失或初始化失败。

详解classnotfoundexception与noclassdeffounderror的区别

ClassNotFoundException 是你主动找类时扑空了

它发生在你明确调用 Class.forName()ClassLoader.loadClass()ClassLoader.findSystemClass() 试图加载一个类,但 JVM 在 classpath 里翻遍也没找到对应字节码文件的时候。

  • Exception(受检异常),编译器强制你处理——不 try-catch 或声明 throws 就过不了编译
  • 典型场景:加载 JDBC 驱动、动态插件、配置化类名初始化(比如 Spring 的 BeanDefinition 解析)
  • 错误信息长这样:java.lang.ClassNotFoundException: com.example.MyService
  • 不是“类不存在”,而是“你指名道姓要它,但它没在 classpath 里”——缺 jar、路径写错、Maven 依赖 scope 写成 test 却在 main 里用,都算

NoClassDefFoundError 是 JVM 自己要用类时突然断供

它发生在运行时 JVM 隐式需要某个类(比如 new 一个对象、访问静态字段、调用静态方法),却发现这个类的定义“曾经存在过,现在没了”——编译时它好好的,运行时却找不着了。

  • Error(非受检错误),不能也不该被 catch,程序基本无法恢复
  • 常见诱因有两个:一是 class 文件或 jar 确实缺失(比如打包漏掉依赖模块);二是类初始化失败后又被二次引用(如静态块抛了 Exception,JVM 记住“这货初始化崩过”,后续所有访问都直接报 NoClassDefFoundError
  • 错误信息示例:java.lang.NoClassDefFoundError: com/example/Utils(注意斜杠不是点)
  • 特别容易误判:它常由 ClassNotFoundException 引发——比如 A 类静态块里 Class.forName("B") 报了 CNFE,A 类初始化失败;之后任何地方 new A() 或访问 A 的静态成员,都会触发 NoClassDefFoundError(报的是 A,不是 B)

怎么快速定位到底是哪个问题

看堆栈第一行 + 错误类型本身就能分八成。但真要挖根,得盯紧“谁触发的类加载”和“类是否真的初始化过”。

LLaMA-Factory Online
LLaMA-Factory Online

在线大模型训练与微调服务平台

下载
  • 如果错误出现在 Class.forName(...)loadClass(...) 调用行,十有八九是 ClassNotFoundException
  • 如果错误出现在 new Xxx()Xxx.staticMethod()Xxx.SOME_CONST 这类代码行,且堆栈里没有反射调用痕迹,优先查 NoClassDefFoundError
  • jps -ljstack <pid></pid> 看线程卡在哪;用 java -verbose:class 启动,观察类加载日志里有没有目标类出现过
  • Maven 多模块项目最危险:war 模块引用了 common 模块的类,但 ear 打包时没把 common.jar 放进 lib 目录——编译全过,运行必崩 NoClassDefFoundError

修复时最容易踩的坑

很多人改完依赖就以为完事,其实关键在“类加载时机”和“类加载器隔离”上。

  • 加了 jar 却还报错?检查是否被其他同名 jar 覆盖——用 mvn dependency:tree -Dincludes=xxx 或 IDEA 的 Maven Helper 插件看实际打进包的是哪个版本
  • Web 应用(Tomcat/JBoss)里,NoClassDefFoundError 很可能是类加载器双亲委派被破坏导致的:你的类在 WEB-INF/lib,但被系统类加载器提前尝试加载(比如用了 Thread.currentThread().getContextClassLoader() 却没设对)
  • 别在静态块里写可能失败的逻辑(如读配置、连 DB)——一旦抛异常,整个类就算“损坏”,后续所有访问都走 NoClassDefFoundError,且错误堆栈不会暴露原始原因
  • Android 上还要额外提防混淆:-keep class com.example.** { *; } 没配全,ClassNotFoundException 可能变成运行时 NoClassDefFoundError(因为类名被改了但反射调用还是用原名)

类加载不是黑盒,它严格区分“显式请求”和“隐式依赖”。你以为只是少了个 jar,实际可能是类加载器层级错位、初始化失败静默污染、或者构建脚本悄悄过滤了资源——这些细节不揪出来,换十次依赖也白搭。

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
如何配置Tomcat环境变量
如何配置Tomcat环境变量

配置Tomcat环境变量需要在系统中添加CATALINA_HOME变量,并将Tomcat的安装路径添加到PATH变量中。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

115

2023.10.26

idea如何集成Tomcat
idea如何集成Tomcat

idea集成Tomcat的步骤:1、添加Tomcat服务器配置;2、配置项目部署;3、运行Tomcat服务器;4、访问项目;5、注意事项;6、关闭Tomcat服务器。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

170

2024.02.23

怎么查看Tomcat源代码
怎么查看Tomcat源代码

查看Tomcat源代码的步骤:1、下载Tomcat源代码;2、在IDEA中导入Tomcat源代码;3、查看源代码;4、理解Tomcat的工作原理;5、参与社区和贡献;6、注意事项;7、持续学习和更新;8、使用工具和插件。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

98

2024.02.23

常见的tomcat漏洞有哪些
常见的tomcat漏洞有哪些

常见的tomcat漏洞有:1、跨站脚本攻击;2、跨站请求伪造;3、目录遍历漏洞;4、缓冲区溢出漏洞;5、配置漏洞;6、第三方组件漏洞。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

169

2024.02.23

tomcat日志乱码怎么解决
tomcat日志乱码怎么解决

tomcat日志乱码的解决办法:1、修改tomcat的日志编码设置;2、检查ide的编码设置;3、检查操作系统的编码设置;4、使用过滤器处理日志;5、检查外部系统的编码设置;6、检查文件编码方式等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

155

2024.02.23

weblogic和tomcat有哪些区别
weblogic和tomcat有哪些区别

weblogic和tomcat的区别:1、功能;2、性能;3、规模;4、价格;5、安全性;6、配置和管理;7、社区支持;8、集成能力;9、升级和更新;10、可靠性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

200

2024.02.23

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

240

2024.02.23

tomcat启动闪退怎么解决
tomcat启动闪退怎么解决

tomcat启动闪退的解决办法:1、检查java环境;2、检查环境变量配置;3、检查端口被占用;4、检查配置文件编码;5、检查启动时需要的配置文件;6、检查相关文件是否丢失;7、检查防火墙和杀毒软件设置。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

167

2024.02.23

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

283

2026.02.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号