NoClassDefFoundError解决方案

  • 一、背景描述
  • 二、原因分析
  • 三、解决方案
    • 3.1 初始化错误解决
    • 3.2 无法找到类文件解决方案

一、背景描述

Springboot + JDK1.8，程序正常编译通过，运行时调用某个类后抛出异常。
在编译时没有异常的程序，在运行时抛出异常称 NoClassDefFoundError: Could not initialize class 类名。详细报错信息如下图所示：

二、原因分析

根据 Java 官方文档，NoClassDefFoundError 是由于 JVM 或 ClassLoader 实例为了调用某个类的方法或 new 类的新的实例，而试图加载该类的定义时，却无法找到其定义，而抛出的异常。需要注意，对于抛出该异常的情况，试图找到的类的定义在编译时存在，只是在运行时不知所踪。
NoClassDefFoundError 总的来讲有两种情况，类文件不存在，或是类初始化错误。而它们的错误信息也不同，我们可以根据显示信息区分开。

  • 如果类文件初始化错误，错误信息则如前文所提，为 NoClassDefFoundError: Could not initialize class 类名。这通常由类的静态成员或静态初始化语句块引起。比如 private static final ApplicationEventPublisher eventPublisher = SpringUtil.getBean(ApplicationEventPublisher.class); 或直接执行于 static {} 代码块中的语句抛出异常，都可能会引发 NoClassDefFoundError。针对这第一种这种情况，可以在类的 static initializer 中增加 try{} catch(){} 语句来捕获异常并输出日志，来了解具体错误内容。
  • 如果无法找到类文件，错误信息为 java.lang.NoClassDefFoundError: com/example/某类。

三、解决方案

针对上述两种不同的错误内容，我们分别列出以下解决方式方便选择：

3.1 初始化错误解决

如果不知道是哪个类出现了错误，那么我们就在出现问题的代码出加上 try{} catch() {}，语句块，在重新运行程序，报错信息会详细打印出那个类出现了问题，比如以下代码：
比如重启以后的详细报错信息
从图中可以知道是 由于 没有可用的 ApplicationEventPublisher 实例导致的，那么我们就可以从类中找出与它有关的代码然后修改掉即可。对于我来说，这段代码我先注释掉了，不影响业务，或者是写出能代替的方案即可。

3.2 无法找到类文件解决方案

可能是由于缺少依赖的问题，把依赖加上重新编译后再重新验证。或者如果是缺少类，则把缺少的类添加上即可。

本文完结！