手动更新jar包中的class文件,报java.lang.ClassNotFoundException或java.lang.NoClassDefFoundError问题记录

博客讨论了在服务器部署时遇到的NoClassDefFoundError和ClassNotFoundException异常。问题源于类加载的不同阶段,NoClassDefFoundError在初始化阶段报错,而ClassNotFoundException在加载阶段找不到类。解决办法是确保在手动更新jar包时包含所有匿名内部类的class文件。这提醒开发者在更新jar时需仔细检查所有依赖和子类。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

1.问题描述

  本地代码运行无问题,手动更新class文件到jar包,部署到服务器的tomcat上启动时无报错,但登录网站使用 对应功能 时,报 java.lang.ClassNotFoundException 或 java.lang.NoClassDefFoundError 异常。
  java.lang.NoClassDefFoundError 异常堆栈:

SEVERE: Servlet.service() for servlet [WFMDownloadFOAServlet] in context with path [/oss] threw exception [Servlet execution threw an exception] with root cause
java.lang.NoClassDefFoundError: Could not initialize class com.ztesoft.zsmart.oss.prj.entel2.wfm.util.HttpsUtil
	at com.ztesoft.zsmart.oss.prj.entel2.wfm.servlet.CustDownloadFOAServlet.doGet(CustDownloadFOAServlet.java:75)
	at javax.servlet.http.HttpServlet.service(HttpServlet.java:624)
	at javax.servlet.http.HttpServlet.service(HttpServlet.java:731)
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:303)
	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:208)
	at org.apache.tomcat.websocket.server.WsFilter.doFilter(WsFilter.java:52)
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:241)
	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:208)
	at org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:219)
	at org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:110)
	at org.apache.catalina.authenticator.AuthenticatorBase.invoke(AuthenticatorBase.java:506)
	at org.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:169)
	at org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:103)
	at org.apache.catalina.valves.AccessLogValve.invoke(AccessLogValve.java:962)
	at org.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:116)
	at org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:445)
	at org.apache.coyote.http11.AbstractHttp11Processor.process(AbstractHttp11Processor.java:1115)
	at org.apache.coyote.AbstractProtocol$AbstractConnectionHandler.process(AbstractProtocol.java:637)
	at org.apache.tomcat.util.net.JIoEndpoint$SocketProcessor.run(JIoEndpoint.java:316)
	at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1145)
	at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:615)
	at org.apache.tomcat.util.threads.TaskThread$WrappingRunnable.run(TaskThread.java:61)
	at java.lang.Thread.run(Thread.java:745)

  java.lang.ClassNotFoundException 异常堆栈:

SEVERE: Servlet.service() for servlet [WFMDownloadFOAServlet] in context with path [/oss] threw exception [Servlet execution threw an exception] with root cause
java.lang.ClassNotFoundException: com.ztesoft.zsmart.oss.prj.entel2.wfm.util.Https$1
	at org.apache.catalina.loader.WebappClassLoaderBase.loadClass(WebappClassLoaderBase.java:1892)
	at org.apache.catalina.loader.WebappClassLoaderBase.loadClass(WebappClassLoaderBase.java:1735)
	at com.ztesoft.zsmart.oss.prj.entel2.wfm.util.Https.<clinit>(Https.java:32)
	at com.ztesoft.zsmart.oss.prj.entel2.wfm.servlet.CustDownloadFOAServlet.doGet(CustDownloadFOAServlet.java:72)
	at javax.servlet.http.HttpServlet.service(HttpServlet.java:624)
	at javax.servlet.http.HttpServlet.service(HttpServlet.java:731)
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:303)
	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:208)
	at org.apache.tomcat.websocket.server.WsFilter.doFilter(WsFilter.java:52)
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:241)
	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:208)
	at org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:219)
	at org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:110)
	at org.apache.catalina.authenticator.AuthenticatorBase.invoke(AuthenticatorBase.java:506)
	at org.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:169)
	at org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:103)
	at org.apache.catalina.valves.AccessLogValve.invoke(AccessLogValve.java:962)
	at org.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:116)
	at org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:445)
	at org.apache.coyote.http11.AbstractHttp11Processor.process(AbstractHttp11Processor.java:1115)
	at org.apache.coyote.AbstractProtocol$AbstractConnectionHandler.process(AbstractProtocol.java:637)
	at org.apache.tomcat.util.net.JIoEndpoint$SocketProcessor.run(JIoEndpoint.java:318)
	at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1145)
	at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:615)
	at org.apache.tomcat.util.threads.TaskThread$WrappingRunnable.run(TaskThread.java:61)
	at java.lang.Thread.run(Thread.java:745)

2.原因分析

java.lang.NoClassDefFoundError:
Could not initialize class com.ztesoft.zsmart.oss.prj.entel2.wfm.util.HttpsUtil

java.lang.ClassNotFoundException: com.ztesoft.zsmart.oss.prj.entel2.wfm.util.Https$1

  java.lang.NoClassDefFoundError与java.lang.ClassNotFoundException这两个报错看似相似,其实不同。NoClassDefFoundError异常是能找到HttpsUtil这个类,但是在初始化这个类的时候报错;而ClassNotFoundException异常就是普通的找不到这个类。这两个报错发生在类加载的不同阶段。
  类加载过程分为加载、链接、初始化。ClassNotFoundException异常发生在加载的过程,在加载com.ztesoft.zsmart.oss.prj.entel2.wfm.util.Https$1这个类时,找不到对应的class文件,因此报错;而NoClassDefFoundError异常发生在类的初始化过程,能找到com.ztesoft.zsmart.oss.prj.entel2.wfm.util.HttpsUtil这个类,但是在初始化这个类的时候报错了。初始化类的时候会去加载这个类的父类,并执行静态代码块,因此要检查这个类引用的父类是否存在或静态代码块中有没有问题。


3.解决方案

idea目录显示
本地idea文件
本地路径目录显示
在这里插入图片描述

知识点:若一个类中使用了匿名内部类,那么编译后会生成匿名内部类的class文件,当我们手动更新jar包时,一定要把匿名内部类的class文件也加进去。

其他比较常见的java.lang.ClassNotFoundException异常多是依赖中的某些jar包缺失,或类缺失。本文问题的根本原因也是类缺失,但是特殊的是是由于 类中使用了匿名内部类 ,在手动更新jar时,忽略了匿名内部类的class文件,这点值得开发人员注意。

### Java中的`java.lang.NoClassDefFoundError`和`java.lang.ClassNotFoundException` #### 错误原因 `java.lang.NoClassDefFoundError`通常发生在Java虚拟机(JVM)试图在运行时加载某个类,但由于某些原因无法找到该类定义的情况下抛出。这种错误可能由多种因素引起,比如类路径配置不正确、类加载器问题者依赖库缺失等[^1]。 另一方面,`java.lang.ClassNotFoundException`则是在编译期就已经能够检测到的错误,通常是由于指定的类未存在于当前项目的类路径中而导致的。这类错误往往更容易解决,因为开发者可以在开发阶段就发现问题所在,并采取相应措施加以修正[^2]。 #### 解决方案 针对`NoClassDefFoundError`,如果确认目标类确实存在,则需进一步排查是否存在以下情况之一: - 类所在的JAR文件未被正确引入至应用的运行环境中; - 存在多个版本冲突的同名类JAR,造成类加载混乱; - 动态代理其他反射机制调用了不存在的方法字段[^3]。 对于`ClassNotFoundException`而言,主要应关注以下几个方面来进行处理: - 确认所需的外部库已添加到项目构建工具(如Maven/Gradle)的依赖列表里; - 如果手动管理依赖关系,则要保证所有必需的.jar文件均已放置于CLASSPATH之下; - 当涉及远程加载资源时,还需验证URL地址的有效性和可达性[^4]。 ```python import java.net.URL; import java.net.URLClassLoader; public class Test { public static void main(String[] args){ try{ URL url = new URL("file:/path/to/classes/"); ClassLoader loader = new URLClassLoader(new URL[]{url}); Class<?> clazz = loader.loadClass("com.example.MyClass"); System.out.println(clazz.getName()); }catch(Exception e){ e.printStackTrace(); } } } ``` 以上代码片段展示了如何利用自定义类加载器去尝试加载特定位置下的某类实例。这对于诊断复杂场景下可能出现的各种class loading issues非常有帮助。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值