Java Could not find or load main class详解

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

首先，java命令正确的语法如下：

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

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

packagename.packagename2.packagename3.ClassName

packagename/packagename2/packagename3/ClassName

这个包路径看着很像是一个文件的名字，但是他不是文件名！！！ 如果你是使用class文件的文件名调用的，这很可能就是你产生这个错误的原因。正确的使用方式中<class-name>应该是一个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
   

2. 使用文件名和路径名，而没有使用FQN（完整的class名字）

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

3. 最后注意，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这个错误。

2. 子路径不匹配

   如果你的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
     

3. class-path缺少依赖

   class-path需要你整个应用所有的依赖的class，也就是为了主类加载正确，JVM需要找到：

   • 主类本身；
   • 所有父亲类以及接口；
   • 所有声明变量的类以及调用的方法等。