Java Could not find or load main class详解

在使用java命令跑java编译好的class文件时,经常会碰到这个错误,本篇博文详细解释下为何会出现这个错误。

首先,java命令正确的语法如下:

java [ <option> ... ] <class-name> [<argument> ...]

其中应为一个Java class的名称,一个完整的java class(FQN fully qulified name)的名称应该如下所示,由于java版本的关系,Java命令行也允许使用/作为包名的分隔符。

packagename.packagename2.packagename3.ClassName
packagename/packagename2/packagename3/ClassName

这个包路径看着很像是一个文件的名字,但是他不是文件名!!! 如果你是使用class文件的文件名调用的,这很可能就是你产生这个错误的原因。正确的使用方式中应该是一个FQN(FQN是java中的术语,不是忽悠你的)

接下来我们看下一个正确的示例:

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

在用以上命令行调用java程序时,实际上java虚拟机会完成以下工作:

  1. 在编译后的class文件中搜索名为com.acme.example.ListUsers的class
  2. 加载这个class
  3. 校验这个class的main方法签名以及返回值类型等
  4. 调用这个方法并传进(“fred”, “joe”, “bert”) 数组作为参数

产生Could not find or load main class的原因

基本上,如果java虚拟机报这个错的话,基本上就是以上步骤的第一步出错了,也就是说java虚拟机找不到这个FQN,并且这个报错会打印出java虚拟机试图搜索的FQN。下面会列举出一些常见的错误原因。

class-name参数错误

这也是最常见的错误类型,如果完全理解FQN的概念的话,则很容易排查这类错误,下面给出几种这类型的错误示例。

  1. 只指定了类名,没有给出完整包名
java ListUser
  1. 使用文件名和路径名,而没有使用FQN(完整的class名字)
java ListUser.class
java com/acme/example/ListUser.class
  1. 最后注意,FQN的名字是大小写敏感的
java com.acme.example.listuser

class-path设置不对

作为一名java开发者,我们都应该知道,class-path的作用是为了告诉java应用,去哪个路径下找应用程序需要的class,所以,如果class-path设置不对,也会导致java虚拟机找不到需要加载的FQN,进而导致could not find or load main class。

  1. class-path路径错误
    从概念上来讲,当你指定一个class-path时,这个class-path即对应应用程序的FQN的命名空间的根路径,在应用程序中用到的所有class都要从这个根路径下搜索,举例来说,你的根路径设置为/usr/local/acme/classes,当你在搜索com.acme.example.Foon这个类时,实际上java虚拟机在搜索的文件为
/usr/local/acme/classes/com/acme/example/Foon.class

如果你使用"/usr/local/acme/classes/com/acme/example作为你的class-path,就会出现could not find or load main class这个错误。

  1. 子路径不匹配
    如果你的FQN名字为com.acme.example.Foon,则JVM会尝试在com/acme/example路径下寻找Foon.class,也就是说如果你的目录结构和FQN的包名不符时,也会导致could not find or load main class。
    下面给出一个例子
  • 你想要运行的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
  1. class-path缺少依赖
    class-path需要你整个应用所有的依赖的class,也就是为了主类加载正确,JVM需要找到:
  • 主类本身;
  • 所有父亲类以及接口;
  • 所有声明变量的类以及调用的方法等。