本文适用于当前面临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