java.lang.ClassNotFoundException：如何解决

60 阅读 0 评论 40 点赞

我是靠谱客的博主霸气茉莉，最近开发中收集的这篇文章主要介绍java.lang.ClassNotFoundException：如何解决，觉得挺不错的，现在分享给大家，希望可以做个参考。

概述

本文适用于当前面临java.lang.ClassNotFoundException挑战的Java初学者。它将为您提供此常见Java异常的概述，这是一个示例Java程序，可支持您的学习过程和解决策略。

如果您对与更高级的类加载器相关的问题感兴趣，我建议您复习有关java.lang.NoClassDefFoundError的文章系列，因为这些Java异常密切相关。

java.lang.ClassNotFoundException：概述

根据Oracle文档，在类加载调用失败后，将使用其字符串名称引发ClassNotFoundException ，如下所示：

Class.forName方法
ClassLoader.findSystemClass方法
ClassLoader.loadClass方法

换句话说，这意味着一个特定的Java类找不到或无法从您的应用程序当前上下文类加载器“运行”加载。

对于Java初学者来说，这个问题可能特别令人困惑。这就是为什么我始终建议Java开发人员学习和完善他们在Java类加载器方面的知识的原因。除非您参与动态类加载和使用Java Reflection API，否则您遇到的ClassNotFoundException错误不是来自应用程序代码，而是来自引用API。另一个常见的问题模式是错误包装您的应用程序代码。我们将在本文结尾处回到解决策略。

java.lang。 ClassNotFoundException ：示例Java程序

现在在下面找到一个非常简单的Java程序，该程序通过Class.forName（）和ClassLoader.loadClass（）模拟两种最常见的ClassNotFoundException方案。请简单地复制/粘贴并使用您选择的IDE运行该程序（ 此示例使用Eclipse IDE ）。

Java程序允许您根据以下情况在问题场景1或问题场景2之间进行选择。根据您要研究的场景，只需更改为1或2。

＃Class.forName（）

private static final int PROBLEM_SCENARIO = 1;

＃ClassLoader.loadClass（）

private static final int PROBLEM_SCENARIO = 2;

＃ClassNotFoundExceptionSimulator

package org.ph.javaee.training5;
/**
* ClassNotFoundExceptionSimulator
* @author Pierre-Hugues Charbonneau
*
*/
public class ClassNotFoundExceptionSimulator {
private static final String CLASS_TO_LOAD = "org.ph.javaee.training5.ClassA";
private static final int PROBLEM_SCENARIO = 1;
/**
* @param args
*/
public static void main(String[] args) {
System.out.println("java.lang.ClassNotFoundException Simulator - Training 5");
System.out.println("Author: Pierre-Hugues Charbonneau");
System.out.println("http://javaeesupportpatterns.blogspot.com");
switch(PROBLEM_SCENARIO) {
// Scenario #1 - Class.forName()
case 1:
System.out.println("
** Problem scenario #1: Class.forName() **
");
try {
Class<?> newClass = Class.forName(CLASS_TO_LOAD);
System.out.println("Class "+newClass+" found successfully!");
} catch (ClassNotFoundException ex) {
ex.printStackTrace();
System.out.println("Class "+CLASS_TO_LOAD+" not found!");
} catch (Throwable any) {
System.out.println("Unexpected error! "+any);
}
break;
// Scenario #2 - ClassLoader.loadClass()
case 2:
System.out.println("
** Problem scenario #2: ClassLoader.loadClass() **
");
try {
ClassLoader classLoader = Thread.currentThread().getContextClassLoader();
Class<?> callerClass = classLoader.loadClass(CLASS_TO_LOAD);
Object newClassAInstance = callerClass.newInstance();
System.out.println("SUCCESS!: "+newClassAInstance);
} catch (ClassNotFoundException ex) {
ex.printStackTrace();
System.out.println("Class "+CLASS_TO_LOAD+" not found!");
} catch (Throwable any) {
System.out.println("Unexpected error! "+any);
}
break;
}
System.out.println("
Simulator done!");
}
}

＃ClassA

package org.ph.javaee.training5;
/**
* ClassA
* @author Pierre-Hugues Charbonneau
*
*/
public class ClassA {
private final static Class<ClassA> CLAZZ = ClassA.class;
static {
System.out.println("Class loading of "+CLAZZ+" from ClassLoader '"+CLAZZ.getClassLoader()+"' in progress...");
}
public ClassA() {
System.out.println("Creating a new instance of "+ClassA.class.getName()+"...");
doSomething();
}
private void doSomething() {
// Nothing to do...
}
}

如果按原样运行该程序，则每种情况的输出如下：

＃方案1输出（基准）

java.lang.ClassNotFoundException
模拟器–训练5

作者：Pierre-Hugues Charbonneau

http://javaeesupportpatterns.blogspot.com

**问题场景1：Class.forName（）**

正在从ClassLoader’sun.misc.Launcher$AppClassLoader@bfbdb0’加载org.ph.javaee.training5.ClassA类。

成功找到类org.ph.javaee.training5.ClassA类！

模拟器完成！

＃方案2输出（基准）

java.lang.ClassNotFoundException
模拟器–训练5

作者：Pierre-Hugues Charbonneau

http://javaeesupportpatterns.blogspot.com

**问题场景2：ClassLoader.loadClass（）**

正在从ClassLoader’sun.misc.Launcher$AppClassLoader@2a340e’加载org.ph.javaee.training5.ClassA类的类…

正在创建org.ph.javaee.training5.ClassA的新实例…

成功！：org.ph.javaee.training5.ClassA@6eb38a

模拟器完成！

对于“基准”运行，Java程序能够加载
A类
成功。

现在让我们自愿更改的全名
A类
并针对每种情况重新运行该程序。可以观察到以下输出：

#ClassA更改为ClassB

private static final String CLASS_TO_LOAD = "org.ph.javaee.training5.ClassB";

＃方案1输出（问题复制）

java.lang.ClassNotFoundException
模拟器–训练5

作者：Pierre-Hugues Charbonneau

http://javaeesupportpatterns.blogspot.com

**问题场景1：Class.forName（）**

java.lang.ClassNotFoundException
：org.ph.javaee.training5.ClassB

在java.net.URLClassLoader $ 1.run（
URLClassLoader.java:366
）

在java.net.URLClassLoader $ 1.run（
URLClassLoader.java:355
）

在java.security.AccessController.doPrivileged（
本机方法
）

在java.net.URLClassLoader.findClass（
URLClassLoader.java:354
）

在java.lang.ClassLoader.loadClass（
ClassLoader.java:423
）

在sun.misc.Launcher $ AppClassLoader.loadClass（
Launcher.java:308
）

在java.lang.ClassLoader.loadClass（
ClassLoader.java:356
）

在java.lang.Class.forName0（
本机方法
）

在java.lang.Class.forName（
Class.java:186
）

在org.ph.javaee.training5.ClassNotFoundExceptionSimulator.main（
ClassNotFoundExceptionSimulator.java:29
）

找不到org.ph.javaee.training5.ClassB类！

模拟器完成！

＃方案2输出（问题复制）

java.lang.ClassNotFoundException
模拟器–训练5

作者：Pierre-Hugues Charbonneau

http://javaeesupportpatterns.blogspot.com

**问题场景2：ClassLoader.loadClass（）**

java.lang.ClassNotFoundException
：org.ph.javaee.training5.ClassB

在java.net.URLClassLoader $ 1.run（
URLClassLoader.java:366
）

在java.net.URLClassLoader $ 1.run（
URLClassLoader.java:355
）

在java.security.AccessController.doPrivileged（
本机方法
）

在java.net.URLClassLoader.findClass（
URLClassLoader.java:354
）

在java.lang.ClassLoader.loadClass（
ClassLoader.java:423
）

在sun.misc.Launcher $ AppClassLoader.loadClass（
Launcher.java:308
）

在java.lang.ClassLoader.loadClass（
ClassLoader.java:356
）

在org.ph.javaee.training5.ClassNotFoundExceptionSimulator.main（
ClassNotFoundExceptionSimulator.java:51
）

找不到org.ph.javaee.training5.ClassB类！

模拟器完成！

发生了什么？好吧，因为我们将完整的类名更改为org.ph.javaee.training5.ClassB，所以在运行时找不到此类（不存在），从而导致Class.forName（）和ClassLoader.loadClass（）调用均失败。

您还可以通过将该程序的每个类打包到其自己的JAR文件中，然后从主类路径中省略包含ClassA.class的jar文件来复制此问题。请尝试一下并亲自查看结果…（提示：NoClassDefFoundError）

现在，让我们跳到解决策略。

java.lang。 ClassNotFoundException
：解决策略

现在您已经了解了这个问题，现在该解决它了。解决方法可能非常简单，也可能非常复杂，具体取决于根本原因。

[这里是图片001]

不要太过复杂的根本原因，首先要排除最简单的原因。
首先根据上述内容检查java.lang.ClassNotFoundException堆栈跟踪，并确定在运行时未正确加载哪个Java类，例如应用程序代码，第三方API，Java EE容器本身等。
确定调用者，例如您在调用Class.forName（）或ClassLoader.loadClass（）之前从堆栈跟踪中看到的Java类。与第三方API相比，这将有助于您了解应用程序代码是否出错。
确定您的应用程序代码是否未正确打包，例如，类路径中缺少JAR文件
如果缺少的Java类不是来自您的应用程序代码，请确定它是否属于您正在按照Java应用程序使用的第三方API。一旦识别出它，就需要将丢失的JAR文件添加到运行时类路径或Web应用程序WAR / EAR文件中。
如果在多次解析尝试后仍然挣扎，则可能意味着更复杂的类加载器层次结构问题。在这种情况下，请查看我的NoClassDefFoundError文章系列，以获取更多示例和解决方案

我希望本文能帮助您理解和重新了解这种常见的Java异常。

如果您仍在努力解决java.lang.ClassNotFoundException问题，请随时发表任何评论或问题。

参考： java.lang.ClassNotFoundException：如何从Java EE支持模式和Java教程博客的JCG合作伙伴 Pierre-Hugues Charbonneau 解决。