java.lang.ClassNotFoundException：如何解决

本文适用于当前面临java.lang.ClassNotFoundException挑战的Java初学者。它将为您提供此常见Java异常的概述，这是一个示例Java程序，可支持您的学习过程和解决策略。如果您对与更高级的类加载器相关的问题感兴趣，我建议您复习有关java.lang.NoClassDefFoundError的文章系列，因为这些Java异常密切相关。java.lang...

dnc8371

74310人浏览 · 2020-05-13 01:53:03

dnc8371 · 2020-05-13 01:53:03 发布

本文适用于当前面临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("\n** Problem scenario #1: Class.forName() **\n");
                           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("\n** Problem scenario #2: ClassLoader.loadClass() **\n");                     
                           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("\nSimulator 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
：解决策略

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

不要太过复杂的根本原因，首先要排除最简单的原因。
首先根据上述内容检查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 解决。

翻译自: https://www.javacodegeeks.com/2012/11/java-lang-classnotfoundexception-how-to-resolve.html

腾讯云开发者社区

腾讯云面向开发者汇聚海量精品云计算使用和开发经验，营造开放的云计算技术生态圈。

更多推荐

计算机网络微课堂笔记

腾讯云开发者社区

Rabbitmq在java中的使用

腾讯云开发者社区

java try catch 之后定位不到具体报错行_JAVA入门（三）上

点击蓝字｜关注我们一、异常与异常处理异常简介代码中：阻止当前方法或作用域继续实现的，称之为异常java中的所有异常类都继承Throwable类，Exception 的父类是 Throwable编码环境用户操作输入出现问题由java虚拟机自动抛出和自动捕获需要手动添加抛出和捕获语句文件找不到ThrowableErrorException虚拟机错误 VirtualMachineError...