java.lang.ClassNotFoundException如何解决

JAY.LIN 收录于未分类

2025-01-02 约 3114 字预计阅读 7 分钟

https://bing.ee123.net/img/rand?artid=106706472

java.lang.ClassNotFoundException：如何解决

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

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

java.lang.ClassNotFoundException：概述

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

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

换句话说，这意味着一个特定的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

问题场景 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

问题场景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

问题场景 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

问题场景 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 文件中。
如果在多次解析尝试后仍然挣扎，则可能意味着更复杂的类加载器层次结构问题。在这种情况下，请查看我的文章系列，以获取更多示例和解决方案

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

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

参考： 从博客的 Pierre-Hugues Charbonneau 。

翻译自:

目录

java.lang.ClassNotFoundException如何解决

java.lang.ClassNotFoundException：如何解决