java找不到或无法加载主类

刚开始做Java开发的人遇到的一个常见问题是，他们的程序无法运行并显示错误消息：找不到或加载主类 Could not find or load main class。。。

这意味着什么，是什么原因造成的，我们应该如何修复它呢？

java <class name>命令语法

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

正常的语法是这样的：

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

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

还有一些其他的语法，在这个答案的末尾描述。

该类的完全限定名（FQN）按惯例是用Java源代码编写的；例如

packagename.packagename2.packagename3.ClassName

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

packagename/packagename2/packagename3/ClassName

它看起来像一个文件路径名，但不是。请注意，术语完全限定名是标准的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找不到类的原因

当您收到消息“找不到或无法加载主类”时，这意味着第一步失败。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-应用程序的类路径classpath指定不正确

第二个可能的原因是类名是正确的，但是java命令找不到类。要理解这一点，您需要理解classpath“类路径”的概念。可以参考之前几篇的文章介绍：

• 如何设置类路径classpath
• Java中PATH与CLASSPATH的区别

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

1. 阅读上面链接的二个文档。（Java程序员至少要了解Java类路径机制的基本工作原理，这一点很重要。）

2. 查看运行java命令时生效的命令行和/或CLASSPATH环境变量。检查目录名和JAR文件名是否正确。

3. 如果类路径中有相对路径名，请检查它们是否正确解析。。。从运行java命令时生效的当前目录。

4. 检查类（错误消息中提到的）是否可以位于有效的classpath类路径上。

5. 请注意，Windows与Linux和macos的类路径语法不同。（类路径分隔符为；在Windows上；在其他窗口上：在其他窗口上。如果您为您的平台使用了错误的分隔符，您将不会得到明确的错误消息。相反，您将在路径上得到一个不存在的文件或目录，该文件或目录将被静默忽略。）

原因2a-类路径classpath上的目录错误

当您将目录放在类路径classpath上时，它在概念上对应于限定名称空间的根。通过将完全限定名映射到路径名，类位于该根下的目录结构中。例如，如果“/usr/local/acme/classes”在classpath上，那么当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将查找Foon.class在“com/acme/example”目录中：

• 如果您的目录结构与按照上述模式命名的包不匹配，JVM将找不到您的类。
• 如果您试图通过移动类来重命名它，那么也会失败。。。但是异常stacktrace会有所不同。可以这样说：

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

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

举一个具体的例子，假设：

• 你想运行com.acme.example.Foon class，
• 完整的文件路径是/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等各自的手动条目。
• 在类路径classpath中选择绝对路径名和相对路径名时，请仔细考虑。请记住，如果当前目录发生更改，相对路径名可能会“中断”。

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

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

• 类本身。
• 超类层次结构中的所有类和接口
• 通过变量或变量声明、方法调用或字段访问表达式引用的所有类和接口。

（注意：JLS和JVM规范允许JVM在某些范围内“延迟”加载类，这可能会影响抛出类加载器异常的时间。）

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

偶尔会有人将源代码文件放入源代码树中的错误文件夹，或者遗漏包声明。如果您在IDE中这样做，IDE的编译器会立即告诉您这一点。类似地，如果您使用一个像样的java构建工具，该工具将以一种能够检测问题的方式运行javac。但是，如果您手工构建Java代码，您可以这样做：编译器不会注意到问题，并且生成的“.class”文件不在您期望的位置。

还是找不到问题？

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

此外，请考虑从网站、文档等复制和粘贴不可见或非ASCII字符可能导致的问题。想想“同形文字”，两个字母或符号看起来一样。。。但他们不是。

最后，如果尝试从（META-INF/*.SF）中签名不正确的JAR文件启动，显然会遇到这个问题。

java的可选语法

使用java命令启动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文件的清单中指定。

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

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

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

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

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

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

IDE集成环境

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

但是，如果您在IDE后面做一些事情，仍然有可能发生这种异常。例如，如果您以前在Eclipse中为Java应用程序设置了一个应用程序启动程序，然后将包含“main”类的JAR文件移动到文件系统中的另一个位置，而没有告诉Eclipse，那么Eclipse会在不知情的情况下使用不正确的类路径启动JVM。

简而言之，如果您在IDE中遇到这个问题，请检查诸如过时IDE状态、损坏的项目引用或损坏的启动程序配置之类的情况。

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