4年前 (2021-02-24)  Java系列 |   抢沙发  2649 
文章评分 3 次,平均分 3.3

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:

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。检查javajavac等各自的手动条目。
  • 在类路径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、重建项目等其他方法是值得的。

 

除特别注明外,本站所有文章均为老K的Java博客原创,转载请注明出处来自https://javakk.com/1579.html

关于

发表评论

表情 格式

暂无评论

登录

忘记密码 ?

切换登录

注册