“找不到或加载主类”是什么意思？

Question

新的 Java 开发人员遇到的一个常见问题是他们的程序无法运行并显示错误消息：Could not find or load main class ...

这是什么意思，是什么原因造成的，应该如何解决？

Answer 1

java <class-name> 命令语法

首先，您需要了解使用java（或javaw）命令启动程序的正确方法。

正常的语法¹是这样的：

    java [ <options> ] <class-name> [<arg> ...]

其中<option> 是命令行选项（以“-”字符开头），<class-name> 是完全限定的Java 类名，<arg> 是传递给应用程序的任意命令行参数。

---

^{1 - 在此答案的末尾附近还描述了一些其他语法。}

类的完全限定名 (FQN) 通常按照 Java 源代码编写；例如

    packagename.packagename2.packagename3.ClassName

但是，java 命令的某些版本允许您使用斜杠而不是句点；例如

    packagename/packagename2/packagename3/ClassName

which（令人困惑）看起来像一个文件路径名，但不是一个。请注意，完全限定名称这个术语是标准的 Java 术语......不是我只是为了让你感到困惑而编造的 :-)

下面是java 命令的示例：

    java -Xmx100m com.acme.example.ListUsers fred joe bert

以上将导致java 命令执行以下操作：

1. 搜索 com.acme.example.ListUsers 类的编译版本。
2. 加载类。
3. 检查该类是否具有main 方法，该方法具有由public static void main(String[]) 提供的签名、返回类型 和修饰符。 （注意，方法参数的名称不是签名的一部分。）
4. 调用该方法，将命令行参数（“fred”、“joe”、“bert”）作为String[] 传递给它。

Java 找不到类的原因

当您收到消息“Could not find or load main class ...”时，表示第一步失败。 java 命令找不到类。事实上，消息中的“...”将是java 正在寻找的完全限定的类名。

那为什么会找不到类呢？

原因 #1 - 你在 classname 参数上犯了一个错误

第一个可能的原因是您可能提供了错误的类名。 （或者......正确的类名，但格式错误。）考虑到上面的例子，这里有多种错误的方法来指定类名：

• 示例 #1 - 一个简单的类名：

  java ListUser
  

  当类在com.acme.example这样的包中声明时，您必须使用完整的类名包括java命令中的包名；例如

  java com.acme.example.ListUser
  

• 示例 #2 - 文件名或路径名而不是类名：

  java ListUser.class
  java com/acme/example/ListUser.class
  

• 示例 #3 - 大小写错误的类名：

  java com.acme.example.listuser
  

• 示例 #4 - 一个错字

  java com.acme.example.mistuser
  

• 示例 #5 - 源文件名（Java 11 或更高版本除外；见下文）

  java ListUser.java
  

• 示例 #6 - 你完全忘记了类名

  java lots of arguments
  

原因 #2 - 应用程序的类路径指定错误

第二个可能的原因是类名正确，但是java 命令找不到该类。要理解这一点，您需要了解“类路径”的概念。 Oracle 文档很好地解释了这一点：

• The java command documentation
• Setting the Classpath。
• Java 教程 - PATH and CLASSPATH

所以...如果您正确指定了类名，接下来要检查的是您是否正确指定了类路径：

1. 阅读上面链接的三个文档。 （是的...阅读它们！Java 程序员了解至少 Java 类路径机制如何工作的基础知识是很重要的。）
2. 查看命令行和/或运行java 命令时生效的CLASSPATH 环境变量。检查目录名和 JAR 文件名是否正确。
3. 如果类路径中有相对路径名，请检查它们是否正确解析...从运行java 命令时生效的当前目录。
4. 检查类（在错误消息中提到）是否可以位于有效的类路径中。
5. 请注意，Windows 与 Linux 和 Mac OS 的类路径语法不同。 （类路径分隔符在 Windows 上是 ;，在其他系统上是 :。如果您为您的平台使用了错误的分隔符，您将不会收到明确的错误消息。相反，您将在将被静默忽略的路径。）

原因 #2a - 错误的目录位于类路径中

当您将目录放在类路径上时，它在理论上对应于限定名称空间的根目录。类位于根目录下的目录结构中，通过将完全限定名映射到路径名。因此，例如，如果“/usr/local/acme/classes”在类路径上，那么当 JVM 查找名为 com.acme.example.Foon 的类时，它将查找具有此路径名的“.class”文件：

  /usr/local/acme/classes/com/acme/example/Foon.class

如果您将“/usr/local/acme/classes/com/acme/example”放在类路径中，那么 JVM 将无法找到该类。

原因 #2b - 子目录路径与 FQN 不匹配

如果你的类 FQN 是com.acme.example.Foon，那么 JVM 将在目录“com/acme/example”中查找“Foon.class”：

• 如果您的目录结构与上述模式中的包命名不匹配，则 JVM 将找不到您的类。

• 如果你尝试重命名一个类来移动它，那也会失败......但异常堆栈跟踪会有所不同。可能会这样说：

  Caused by: java.lang.NoClassDefFoundError: <path> (wrong name: <name>)
  

  因为类文件中的 FQN 与类加载器期望找到的不匹配。

举个具体的例子，假设：

• 你想运行com.acme.example.Foon类，
• 完整的文件路径是/usr/local/acme/classes/com/acme/example/Foon.class，
• 您当前的工作目录是/usr/local/acme/classes/com/acme/example/，

然后：

# wrong, FQN is needed
java Foon

# wrong, there is no `com/acme/example` folder in the current working directory
java com.acme.example.Foon

# wrong, similar to above
java -classpath . com.acme.example.Foon

# fine; relative classpath set
java -classpath ../../.. com.acme.example.Foon

# fine; absolute classpath set
java -classpath /usr/local/acme/classes com.acme.example.Foon

注意事项：

• 在大多数 Java 版本中，-classpath 选项可以缩短为 -cp。检查java、javac 等的相应手册条目。
• 在类路径中选择绝对路径名和相对路径名时要仔细考虑。请记住，如果当前目录发生更改，相对路径名可能会“中断”。

原因 #2c - 类路径中缺少依赖项

类路径需要包含您的应用程序所依赖的所有其他（非系统）类。 （系统类是自动定位的，你很少需要关心这个。）为了正确加载主类，JVM需要找到：

• 类本身。
• 超类层次结构中的所有类和接口（例如，参见Java class is present in classpath but startup fails with Error: Could not find or load main class）
• 通过变量或变量声明、方法调用或字段访问表达式引用的所有类和接口。

（注意：JLS 和 JVM 规范允许 JVM 在一定范围内“延迟”加载类，这会影响何时引发类加载器异常。）

原因 #3 - 在错误的包中声明了该类

偶尔会发生有人将源代码文件放入 源代码树中的错误文件夹，或者他们遗漏了package 声明。如果您在 IDE 中执行此操作，IDE 的编译器会立即告诉您这一点。同样，如果您使用一个不错的 Java 构建工具，该工具将以检测问题的方式运行 javac。但是，如果您手动构建您的 Java 代码，您可以这样做，编译器不会注意到问题，并且生成的“.class”文件不在您期望的位置。

还是找不到问题？

要检查的东西很多，很容易漏掉一些东西。尝试将-Xdiag 选项添加到java 命令行（作为java 之后的第一件事）。它将输出有关类加载的各种信息，这可能会为您提供关于真正问题所在的线索。

另外，请考虑从网站、文档等复制和粘贴不可见或非 ASCII 字符可能导致的问题。并考虑“同形文字”，其中两个字母或符号看起来相同......但不是。

如果您在META-INF/*.SF 中有无效或不正确的签名，您可能会遇到此问题。您可以尝试在您最喜欢的 ZIP 编辑器中打开 .jar，然后从 META-INF 中删除文件，直到您只剩下您的 MANIFEST.MF。但是，一般不建议这样做。 （无效签名可能是由于有人将恶意软件注入到原始签名的 JAR 文件中。如果您删除了无效签名，您就是在用恶意软件感染您的应用程序！）推荐的方法是获取具有有效的 JAR 文件签名，或从（真实的）原始源代码重建它们。

最后，如果MANIFEST.MF 文件中存在语法错误，您显然会遇到这个问题（请参阅https://stackoverflow.com/a/67145190/139985）。

---

java 的替代语法

使用java command 启动Java 程序有三种替代语法。

1. 用于启动“可执行”JAR 文件的语法如下：

   java [ <options> ] -jar <jar-file-name> [<arg> ...]
   

   例如

   java -Xmx100m -jar /usr/local/acme-example/listuser.jar fred
   

   入口点类的名称（即com.acme.example.ListUser）和类路径在 JAR 文件的 MANIFEST 中指定。

2. 从模块（Java 9 及更高版本）启动应用程序的语法如下：

   java [ <options> ] --module <module>[/<mainclass>] [<arg> ...]
   

   入口点类的名称要么由<module> 本身定义，要么由可选的<mainclass> 给出。

3. 从 Java 11 开始，您可以使用 java 命令使用以下语法编译和运行单个源代码文件：

   java [ <options> ] <sourcefile> [<arg> ...]
   

   <sourcefile> 是（通常）后缀为“.java”的文件。

更多详细信息，请参阅您正在使用的 Java 版本的java 命令的官方文档。

---

集成开发环境

典型的 Java IDE 支持在 IDE JVM 本身或子 JVM 中运行 Java 应用程序。这些通常不受此特定异常的影响，因为 IDE 使用自己的机制来构造运行时类路径、识别主类并创建 java 命令行。

但是，如果您在 IDE 背后执行操作，则仍有可能发生此异常。例如，如果您之前在 Eclipse 中为您的 Java 应用程序设置了一个应用程序启动器，然后您将包含“main”类的 JAR 文件移动到文件系统中的不同位置而不告诉 Eclipse ，Eclipse 会无意中使用错误的类路径启动 JVM。

简而言之，如果您在 IDE 中遇到此问题，请检查过时的 IDE 状态、损坏的项目引用或损坏的启动器配置等。

IDE 也可能会简单地感到困惑。 IDE 是非常复杂的软件，包含许多交互部分。其中许多部分采用各种缓存策略，以使 IDE 作为一个整体响应。这些有时会出错，一个可能的症状是启动应用程序时出现问题。如果您怀疑这可能会发生，那么值得尝试其他方法，例如重新启动 IDE、重建项目等等。

---

其他参考

• 来自 Oracle Java 教程 - Common Problems (and Their Solutions)

Answer 2

有时可能导致问题的原因与主类无关，我不得不以艰难的方式找出这一点。这是我移动的一个引用库，它给了我：

无法找到或加载主类 xxx Linux

我刚刚删除了那个引用，再次添加它，它又可以正常工作了。

Answer 3

先用这个命令设置路径；

set path="paste the set path address"

然后你需要加载程序。在存储的驱动器中键入“cd（文件夹名称）”并编译它。例如，如果我的程序存储在 D 盘，输入“D:”按回车并输入“cd（文件夹名称）”。

Answer 4

就我而言，出现错误是因为我提供了源文件名而不是类名。

我们需要将包含 main 方法的类名提供给解释器。

Answer 5

如果您的源代码名称是 HelloWorld.java，那么您的编译代码将为HelloWorld.class。

如果您使用以下方式调用它，您将收到该错误：

java HelloWorld.class

改用这个：

java HelloWorld

Answer 6

帮助我的是在命令行上指定类路径，例如：

1. 新建文件夹C:\temp

2. 在C:\temp 中创建文件 Temp.java，其中包含以下类：

   public class Temp {
       public static void main(String args[]) {
           System.out.println(args[0]);
       }
   }
   

3. 在文件夹C:\temp中打开命令行，编写以下命令编译Temp类：

   javac Temp.java
   

4. 运行编译后的 Java 类，添加 -classpath 选项让 JRE 知道在哪里可以找到该类：

   java -classpath C:\temp Temp Hello!
   

Answer 7

带包

如果你的源代码中有package关键字（主类定义在一个包中），你应该在分层目录上运行它，使用类的全名（ packageName.MainClassName)。

假设有一个源代码文件（Main.java）：

package com.test;

public class Main {

    public static void main(String[] args) {
        System.out.println("salam 2nya\n");
    }
}

要运行此代码，您应该将Main.Class 放在 package like 目录中：

C:\Users\workspace\testapp\com\test\Main.Java

然后将终端的当前目录更改为项目的根目录：

cd C:\Users\workspace\testapp  

最后，运行代码：

java com.test.Main

---

无包装

如果您的源代码名称上没有任何包，则可能是您输入了错误的命令。假设你的java文件名是Main.java，编译后：

javac Main.java

您的编译代码将是Main.class

如果您使用以下方式调用它，您将收到该错误：

java Main.class

改用这个：

java Main

Answer 8

如果您的类在包中，那么您必须 cd 到项目的根目录并使用类的完全限定名称 (packageName.MainClassName) 运行。

例子：

我的课程在这里：

D:\project\com\cse\

我的主类的完全限定名称是：

com.cse.Main

于是我cd回到项目根目录：

D:\project

然后发出java 命令：

java com.cse.Main

这个答案是为了让新手 java 程序员摆脱一个常见错误造成的挫败感，我建议你阅读接受的答案，以更深入地了解 java 类路径。

Answer 9

在这种情况下，您有：

找不到或无法加载主类?classpath

这是因为您使用的是“-classpath”，但破折号与java 在命令提示符下使用的破折号不同。我从Notepad 复制粘贴到 cmd 时遇到了这个问题。

Answer 10

当相同的代码在一台 PC 上运行，但在另一台 PC 上显示错误时，我发现的最佳解决方案是编译如下：

javac HelloWorld.java
java -cp . HelloWorld

Answer 11

我花了相当多的时间试图解决这个问题。我以为我以某种方式错误地设置了我的类路径，但问题是我输入了：

java -cp C:/java/MyClasses C:/java/MyClasses/utilities/myapp/Cool  

代替：

java -cp C:/java/MyClasses utilities/myapp/Cool   

我认为完全限定的意思是包含完整的路径名而不是完整的包名。

Answer 12

根据报错信息（“Could not find or load main class”），有两类问题：

1. 无法找到主类
2. 无法加载主类（在接受的答案中没有充分讨论这种情况）

无法找到主类，当完全限定的类名中有错字或语法错误或它在提供的类路径中不存在强>。

当无法启动类时，无法加载主类，通常主类扩展了另一个类，并且该类不存在于提供的类路径中。 p>

例如：

public class YourMain extends org.apache.camel.spring.Main

如果不包含camel-spring，会报这个错误。

Answer 13

在 Java 中，当您有时使用 java 可执行文件从命令行运行 JVM 并尝试从具有 public static void main (PSVM) 的类文件启动程序时，您可能会遇到以下错误，即使JVM 的类路径参数是准确的，并且类文件存在于类路径中：

Error: main class not found or loaded

如果无法加载带有 PSVM 的类文件，则会发生这种情况。一个可能的原因是该类可能正在实现一个接口或扩展另一个不在类路径上的类。通常，如果一个类不在类路径上，则抛出的错误就是这样。但是，如果正在使用的类被扩展或实现，java 就无法加载该类本身。

参考：https://www.computingnotes.net/java/error-main-class-not-found-or-loaded/

Answer 14

在 Windows 上，将 .; 放在开头的 CLASSPATH 值中。

. （点）表示“查看当前目录”。这是一个永久的解决方案。

您也可以使用 set CLASSPATH=%CLASSPATH%;. 将其设置为“一次性”。只要您的 cmd 窗口打开，这将持续。

Answer 15

执行mvn eclipse:eclipse 后出现此错误 这有点搞砸了我的.classpath 文件。

必须将.classpath 中的行从

<classpathentry kind="src" path="src/main/java" including="**/*.java"/>
<classpathentry kind="src" path="src/main/resources" excluding="**/*.java"/>

到

<classpathentry kind="src" path="src/main/java" output="target/classes" />
<classpathentry kind="src" path="src/main/resources" excluding="**"  output="target/classes" />

Answer 16

这是一个具体的案例，但是由于我来到这个页面寻找解决方案并没有找到它，所以我将它添加到这里。

Windows（用 7 测试）不接受类和包名称中的特殊字符（如 á）。不过，Linux 可以。

我在 NetBeans 中构建 .jar 并尝试在命令行中运行它时发现了这一点。它在 NetBeans 中运行，但不在命令行中。

Answer 17

在我的案例中解决问题的是：

右击你想运行的项目/类，然后Run As->Run Configurations。然后，您应该修复现有配置或通过以下方式添加新配置：

打开Classpath标签，点击Advanced...按钮，然后添加您项目的bin文件夹。

Answer 18

我无法使用此处所述的解决方案来解决此问题（尽管所述答案无疑已经清除了我的概念）。我曾两次遇到这个问题，每次都尝试了不同的解决方案（在 Eclipse IDE 中）。

• 首先，我在项目的不同类中遇到了多个main 方法。所以，我已经从后续课程中删除了main 方法。
• 其次，我尝试了以下解决方案：
  1. 右键单击我的主项目目录。
  2. 前往源代码，然后清理并坚持使用默认设置并点击完成。在完成一些后台任务后，您将被定向到您的主项目目录。
  3. 之后我关闭了我的项目，重新打开它，然后繁荣，我终于解决了我的问题。

Answer 19

您确实需要从src 文件夹中执行此操作。在此处键入以下命令行：

[name of the package].[Class Name] [arguments]

假设您的课程名为CommandLine.class，代码如下所示：

package com.tutorialspoint.java;

    /**
     * Created by mda21185 on 15-6-2016.
     */

    public class CommandLine {
        public static void main(String args[]){
            for(int i=0; i<args.length; i++){
                System.out.println("args[" + i + "]: " + args[i]);
            }
        }
    }

那么你应该 cd 到 src 文件夹，你需要运行的命令如下所示：

java com.tutorialspoint.java.CommandLine this is a command line 200 -100

命令行的输出是：

args[0]: this
args[1]: is
args[2]: a
args[3]: command
args[4]: line
args[5]: 200
args[6]: -100

Answer 20

试试 -Xdiag。

Steve C's answer 很好地涵盖了可能的情况，但有时要确定类是无法找到还是加载可能并不那么容易。使用 java -Xdiag（从 JDK 7 开始）。这会打印出一个很好的堆栈跟踪，它提供了消息 Could not find or load main class 消息含义的提示。

例如，它可以将您指向主类使用的其他类，这些类无法找到并阻止加载主类。

Answer 21

在这种情况下我遇到了这样的错误：

java -cp lib.jar com.mypackage.Main

它适用于 Windows 的 ; 和 Unix 的 :：

java -cp lib.jar; com.mypackage.Main

Answer 22

这里的所有答案似乎都是针对 Windows 用户的。对于 Mac，类路径分隔符是 :，而不是 ;。由于没有抛出使用 ; 设置类路径的错误，因此如果从 Windows 到 Mac，这可能很难发现。

这里是对应的Mac命令：

java -classpath ".:./lib/*" com.test.MyClass

在此示例中，包是com.test，并且lib 文件夹也将包含在类路径中。

Answer 23

对于数据库连接，我得到了这个。我刚刚在类路径中添加了以下内容：

export CLASSPATH=<path>/db2jcc4.jar:**./**

我在最后添加了 ./，以便在加载时也能识别我的类。

现在运行：

java ConnectionExample <args>

效果很好。

Answer 24

似乎当我遇到这个问题时，它是独一无二的。

一旦我删除了文件顶部的包声明，它就完美运行了。

除此之外，似乎没有任何方法可以在我的机器上运行简单的 HelloWorld.java，无论编译发生在哪个文件夹、CLASSPATH 或 PATH、参数或调用的文件夹。

Answer 25

使用这个命令：

java -cp . [PACKAGE.]CLASSNAME

示例：如果您的类名是 Hello.class 从 Hello.java 创建的，则使用以下命令：

java -cp . Hello

如果您的文件 Hello.java 在 com.demo 包中，则使用以下命令

java -cp . com.demo.Hello

在 JDK 8 中，类文件经常出现在同一个文件夹中，但 java 命令需要类路径，因此我们添加 -cp . 以获取当前文件夹作为类路径的参考。

Answer 26

类文件位置： C:\test\com\company

文件名： Main.class

完全限定的类名： com.company.Main

命令行命令：

java  -classpath "C:\test" com.company.Main

请注意，类路径不包括 \com\company

Answer 27

默认情况下，Java 使用当前工作目录. 作为默认CLASSPATH。这意味着当您在提示符下键入命令时，例如java MyClass，该命令被解释为您输入了java -cp . MyClass。你看到-cp 和MyClass 之间的那个点了吗？ （cp 是较长的 classpath 选项的缩写）

这对于大多数情况来说已经足够了，而且在您尝试将目录添加到您的CLASSPATH 之前，一切似乎都可以正常工作。在大多数情况下，当程序员需要这样做时，他们只需运行类似set CLASSPATH=path\to\some\dir 的命令。此命令创建一个名为CLASSPATH 的新环境变量，其值为path\to\some\dir，如果之前已设置CLASSPATH，则将其值替换为path\to\some\dir。

完成后，您现在有了一个CLASSPATH 环境变量，Java 不再使用它的默认类路径 (.)，而是使用您设置的那个。所以第二天你打开你的编辑器，写一些java程序，cd到你保存它的目录，编译它，然后尝试用命令java MyClass运行它，你会看到一个很好的输出：无法找到或加载主类...（如果您的命令之前运行良好，而您现在得到此输出，那么您可能就是这种情况）。

当您运行命令 java MyClass 时，Java 会在您在 CLASSPATH 中设置的一个或多个目录中搜索名为 MyClass 的类文件，而不是您当前的工作目录，因此它不会在那里找不到你的类文件，因此抱怨。

您需要做的是再次将. 添加到您的类路径中，这可以使用命令set CLASSPATH=%CLASSPATH%;. 完成（注意分号后面的点）。用简单的英语，这个命令说“选择 CLASSPATH (%CLASSPATH%) 的初始值，将 . 添加到它 (;.) 并将结果分配回 CLASSPATH”。

瞧，你又可以像往常一样使用你的命令java MyClass了。

Answer 28

当运行 java 和 Windows PowerShell 中所宣传的 -cp 选项时，您可能会收到类似于以下内容的错误：

The term `ClassName` is not recognized as the name of a cmdlet, function, script ...

为了让 PowerShell 接受命令，-cp 选项的参数必须包含在引号中，如下所示：

java -cp 'someDependency.jar;.' ClassName

以这种方式形成命令应该允许 Java 正确处理类路径参数。

Answer 29

如果您的情况与我的情况特别相似，这可能会对您有所帮助：作为初学者，我在尝试运行 Java 程序时也遇到了这个问题。

我是这样编译的：

javac HelloWorld.java

我也尝试使用相同的扩展名运行：

java Helloworld.java

当我删除.java 并重写java HelloWorld 之类的命令时，程序运行完美。 :)

Answer 30

如果使用Maven构建JAR文件，请务必在pom.xml文件中指定主类：

<build>
    <plugins>
        <plugin>
            <artifactId>maven-jar-plugin</artifactId>
            <configuration>
                <archive>
                    <manifest>
                        <mainClass>class name us.com.test.abc.MyMainClass</mainClass>
                    </manifest>
                </archive>
            </configuration>
        </plugin>
    </plugins>
</build>