Ошибка не удалось найти или загрузить основной класс

The java <class-name> command syntax

First of all, you need to understand the correct way to launch a program using the java (or javaw) command.

The normal syntax¹ is this:

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

where <option> is a command line option (starting with a «-» character), <class-name> is a fully qualified Java class name, and <arg> is an arbitrary command line argument that gets passed to your application.

---

^{1 — There are some other syntaxes which are described near the end of this answer.}

The fully qualified name (FQN) for the class is conventionally written as you would in Java source code; e.g.

    packagename.packagename2.packagename3.ClassName

However some versions of the java command allow you to use slashes instead of periods; e.g.

    packagename/packagename2/packagename3/ClassName

which (confusingly) looks like a file pathname, but isn’t one. Note that the term fully qualified name is standard Java terminology … not something I just made up to confuse you

Here is an example of what a java command should look like:

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

The above is going to cause the java command to do the following:

1. Search for the compiled version of the com.acme.example.ListUsers class.
2. Load the class.
3. Check that the class has a main method with signature, return type and modifiers given by public static void main(String[]). (Note, the method argument’s name is NOT part of the signature.)
4. Call that method passing it the command line arguments («fred», «joe», «bert») as a String[].

Reasons why Java cannot find the class

When you get the message «Could not find or load main class …», that means that the first step has failed. The java command was not able to find the class. And indeed, the «…» in the message will be the fully qualified class name that java is looking for.

So why might it be unable to find the class?

Reason #1 — you made a mistake with the classname argument

The first likely cause is that you may have provided the wrong class name. (Or … the right class name, but in the wrong form.) Considering the example above, here are a variety of wrong ways to specify the class name:

• Example #1 — a simple class name:

  java ListUser
  

  When the class is declared in a package such as com.acme.example, then you must use the full classname including the package name in the java command; e.g.

  java com.acme.example.ListUser
  

• Example #2 — a filename or pathname rather than a class name:

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

• Example #3 — a class name with the casing incorrect:

  java com.acme.example.listuser
  

• Example #4 — a typo

  java com.acme.example.mistuser
  

• Example #5 — a source filename (except for Java 11 or later; see below)

  java ListUser.java
  

• Example #6 — you forgot the class name entirely

  java lots of arguments
  

Reason #2 — the application’s classpath is incorrectly specified

The second likely cause is that the class name is correct, but that the java command cannot find the class. To understand this, you need to understand the concept of the «classpath». This is explained well by the Oracle documentation:

• The java command documentation
• Setting the Classpath.
• The Java Tutorial — PATH and CLASSPATH

So … if you have specified the class name correctly, the next thing to check is that you have specified the classpath correctly:

1. Read the three documents linked above. (Yes … READ them! It is important that a Java programmer understands at least the basics of how the Java classpath mechanisms works.)
2. Look at command line and / or the CLASSPATH environment variable that is in effect when you run the java command. Check that the directory names and JAR file names are correct.
3. If there are relative pathnames in the classpath, check that they resolve correctly … from the current directory that is in effect when you run the java command.
4. Check that the class (mentioned in the error message) can be located on the effective classpath.
5. Note that the classpath syntax is different for Windows versus Linux and Mac OS. (The classpath separator is ; on Windows and : on the others. If you use the wrong separator for your platform, you won’t get an explicit error message. Instead, you will get a nonexistent file or directory on the path that will be silently ignored.)

Reason #2a — the wrong directory is on the classpath

When you put a directory on the classpath, it notionally corresponds to the root of the qualified name space. Classes are located in the directory structure beneath that root, by mapping the fully qualified name to a pathname. So for example, if «/usr/local/acme/classes» is on the class path, then when the JVM looks for a class called com.acme.example.Foon, it will look for a «.class» file with this pathname:

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

If you had put «/usr/local/acme/classes/com/acme/example» on the classpath, then the JVM wouldn’t be able to find the class.

Reason #2b — the subdirectory path doesn’t match the FQN

If your classes FQN is com.acme.example.Foon, then the JVM is going to look for «Foon.class» in the directory «com/acme/example»:

• If your directory structure doesn’t match the package naming as per the pattern above, the JVM won’t find your class.

• If you attempt rename a class by moving it, that will fail as well … but the exception stacktrace will be different. It is liable to say something like this:

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

  because the FQN in the class file doesn’t match what the class loader is expecting to find.

To give a concrete example, supposing that:

• you want to run com.acme.example.Foon class,
• the full file path is /usr/local/acme/classes/com/acme/example/Foon.class,
• your current working directory is /usr/local/acme/classes/com/acme/example/,

then:

# 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

Notes:

• The -classpath option can be shortened to -cp in most Java releases. Check the respective manual entries for java, javac and so on.
• Think carefully when choosing between absolute and relative pathnames in classpaths. Remember that a relative pathname may «break» if the current directory changes.

Reason #2c — dependencies missing from the classpath

The classpath needs to include all of the other (non-system) classes that your application depends on. (The system classes are located automatically, and you rarely need to concern yourself with this.) For the main class to load correctly, the JVM needs to find:

• the class itself.
• all classes and interfaces in the superclass hierarchy (e.g. see Java class is present in classpath but startup fails with Error: Could not find or load main class)
• all classes and interfaces that are referred to by means of variable or variable declarations, or method call or field access expressions.

(Note: the JLS and JVM specifications allow some scope for a JVM to load classes «lazily», and this can affect when a classloader exception is thrown.)

Reason #3 — the class has been declared in the wrong package

It occasionally happens that someone puts a source code file into the
the wrong folder in their source code tree, or they leave out the package declaration. If you do this in an IDE, the IDE’s compiler will tell you about this immediately. Similarly if you use a decent Java build tool, the tool will run javac in a way that will detect the problem. However, if you build your Java code by hand, you can do it in such a way that the compiler doesn’t notice the problem, and the resulting «.class» file is not in the place that you expect it to be.

Still can’t find the problem?

There lots of things to check, and it is easy to miss something. Try adding the -Xdiag option to the java command line (as the first thing after java). It will output various things about class loading, and this may offer you clues as to what the real problem is.

Also, consider possible problems caused by copying and pasting invisible or non-ASCII characters from websites, documents and so on. And consider «homoglyphs», where two letters or symbols look the same … but aren’t.

You may run into this problem if you have invalid or incorrect signatures in META-INF/*.SF. You can try opening up the .jar in your favorite ZIP editor, and removing files from META-INF until all you have is your MANIFEST.MF. However this is NOT RECOMMENDED in general. (The invalid signature may be the result of someone having injected malware into the original signed JAR file. If you erase the invalid signature, you are in infecting your application with the malware!) The recommended approach is to get hold of JAR files with valid signatures, or rebuild them from the (authentic) original source code.

Finally, you can apparently run into this problem if there is a syntax error in the MANIFEST.MF file (see https://stackoverflow.com/a/67145190/139985).

---

Alternative syntaxes for java

There are three alternative syntaxes for the launching Java programs using the java command.

1. The syntax used for launching an «executable» JAR file is as follows:

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

   e.g.

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

   The name of the entry-point class (i.e. com.acme.example.ListUser) and the classpath are specified in the MANIFEST of the JAR file.

2. The syntax for launching an application from a module (Java 9 and later) is as follows:

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

   The name of the entrypoint class is either defined by the <module> itself, or is given by the optional <mainclass>.

3. From Java 11 onwards, you can use the java command to compile and run a single source code file using the following syntax:

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

   where <sourcefile> is (typically) a file with the suffix «.java».

For more details, please refer to the official documentation for the java command for the Java release that you are using.

---

IDEs

A typical Java IDE has support for running Java applications in the IDE JVM itself or in a child JVM. These are generally immune from this particular exception, because the IDE uses its own mechanisms to construct the runtime classpath, identify the main class and create the java command line.

However it is still possible for this exception to occur, if you do things behind the back of the IDE. For example, if you have previously set up an Application Launcher for your Java app in Eclipse, and you then moved the JAR file containing the «main» class to a different place in the file system without telling Eclipse, Eclipse would unwittingly launch the JVM with an incorrect classpath.

In short, if you get this problem in an IDE, check for things like stale IDE state, broken project references or broken launcher configurations.

It is also possible for an IDE to simply get confused. IDE’s are hugely complicated pieces of software comprising many interacting parts. Many of these parts adopt various caching strategies in order to make the IDE as a whole responsive. These can sometimes go wrong, and one possible symptom is problems when launching applications. If you suspect this could be happening, it is worth trying other things like restarting your IDE, rebuilding the project and so on.

---

Other References

• From the Oracle Java Tutorials — Common Problems (and Their Solutions)

Если вы по-прежнему получаете ошибку «основной класс не найден» в вашем Java-проекте без видимой причины, не волнуйтесь, вы не одиноки.

Как одна из самых непредвиденных и спонтанных ошибок, благодаря тенденции JVM (виртуальная машина Java) придерживаться пути к классам по умолчанию, проблема «основной класс не найден» – это то, что преследует как любителей, так и профессионалов.

Но этот вопрос на самом деле менее пугающий, чем кажется. Читайте дальше, чтобы узнать, как избавиться от этой ошибки раз и навсегда.

Почему не был найден основной класс?

Прежде чем мы попытаемся понять, как и почему JVM не смогла найти основной класс, нам нужно понять концепцию пути к классам в Java.

Что такое Classpath?

Путь к классам – это путь к файлу, по которому среда выполнения Java ищет классы и другие файлы ресурсов. Его можно установить с помощью параметра -classpath при выполнении программы или путем установки системной переменной среды CLASSPATH .

Как следует из названия, это просто путь к файлу, по которому файлы .class можно найти в пакете или каталоге JDK.

Когда JVM не может найти основной класс, это часто связано с тем, что она ищет соответствующие файлы .class в неправильном пути к классам. Конечно, способ исправить эту проблему – вручную указать путь к классам, используя пакеты или указав путь к классам.

На этом этапе, если вы хотите освежить память о классах Java, ознакомьтесь с нашим руководством по созданию классов в Java .

Использование пакетов

Создадим класс под названием Test . Поместите его в пакет под названием testPackage . Пакеты используются в Java для того, чтобы сгруппировать похожие классы вместе или предоставить уникальное пространство имен для классов.

В этом простом примере использование пакета поможет вам наглядно представить, как работает путь к классам Java. В вашем приложении файлового менеджера пакет представлен как независимая папка.

 package testPackage;
 public class Test {
 public static void main(String args[]) {
 System.out.println("File successfully found!");
 }
 }

Теперь откройте новый терминал и убедитесь, что ваш рабочий каталог совпадает с тем, который содержит папку пакета. Вы можете изменить рабочий каталог с помощью команды cd в любой операционной системе.

Скомпилируйте Test.java , выполнив следующую команду:

 package testPackage;
 javac testPackage/Test.java

Это сохранит скомпилированный двоичный файл (файл .class) в testPackage.

Чтобы запустить скомпилированный класс, вам нужно ввести полное имя класса в командной строке. Полное имя класса Java относится к его имени с префиксом имени пакета. В этом случае это должно выглядеть примерно так:

 java testPackage.Test

Этот способ вызова файлов классов также гарантирует, что вы можете вызывать исполняемые файлы из разных пакетов из одного и того же рабочего каталога. Все, что вам нужно сделать, это изменить полное имя класса.

В более продвинутых реализациях мы рекомендуем создавать отдельные подпапки для ваших классов и исходных файлов, чтобы лучше управлять файлами в пакете.

Указание пути к классам вручную

Рекомендуемый способ управления файлами Java – создание отдельных каталогов для исходных файлов и классов. Если вы работаете над проектом, скорее всего, вы уже этим занимаетесь.

Обычно каталог с исходными файлами обозначается как src, а каталог с файлами .class обозначается как классы. Это также способ гарантировать, что вероятность того, что JVM не найдет основной класс, значительно снижена благодаря правильно структурированному каталогу.

Если мы воспользуемся этим методом, то структура каталогов будет выглядеть перед компиляцией так:

 |---myFolder
 | |---src
 | |---testPackage
 | |---Test.java
 |
 | |---classes

Каждый отступ на приведенной выше иллюстрации соответствует одному уровню файловой иерархии, которому должен следовать ваш проект.

Чтобы скомпилировать это, убедитесь, что ваш рабочий каталог – myFolder. Теперь введите следующую команду:

 javac -d classes src/testPackage/Test.java

Исполняемый файл .class следует сохранить в myFolder / classes / testPackage . Соответственно структура файловых каталогов выглядит примерно так:

 |---myFolder
 | |---src
 | |---testPackage
 | |---Test.java
 |
 | |---classes
 | |---testPackage
 | |---Test.class

Чтобы запустить файл .class , запустите команду Java с полным именем класса и укажите локальный путь к классам. Каждый путь объявляется относительно рабочего каталога, которым в данном случае является myFolder.

 java -classpath classes testPackage

Выполнение этой команды должно дать вам желаемый результат. Но почему для решения простой ошибки требуется столько реорганизации?

Причина появления сообщения «Не удалось найти или загрузить основной класс» заключается в том, что JVM не смогла найти, где хранились ваши файлы .class .

Самый простой способ устранить эту ошибку – указать, где хранятся файлы .class, и явно указать JVM искать там. Это стало возможным благодаря раздельной организации исходных и исполняемых файлов и контролю всего из рабочего каталога.

Когда вы начнете добавлять в проект такие конструкции, как наследование , сложность файловой системы неизбежно возрастет в разы. В таких проектах или даже в тех, где требуется использование файлов JAR или пользовательских библиотек, простая практика разделения файлов и управления ими может сэкономить вам бесчисленные часы устранения неполадок и отладки.

Чтобы узнать больше о том, как classpath работает в Java, и о многочисленных вещах, которыми вы можете управлять, когда дело доходит до запуска вашего кода, вы также можете взглянуть на подробный и удобный справочник Oracle.

Ошибка « Не удалось найти или загрузить основной класс » возникает при использовании команды java в командной строке для запуска программы Java путем указания имени класса в терминале. Причина, по которой это происходит, в основном связана с ошибкой программирования пользователя при объявлении класса.

Как уже упоминалось раньше эта ошибка в основном не связана с системой, и пользователь допускает ошибку в нескольких сценариях, как показано ниже. Прежде чем двигаться дальше, мы предполагаем, что у вас есть базовые знания о языке программирования Java и о том, как он работает.

Что вызывает ошибку «Не удалось найти или загрузить основной класс» в Java?

Сообщение «Не удалось найти или загрузить основной класс» означает, что первый шаг Механизм Java не смог получить класс для выполнения. java-команде не удалось найти класс в правильном каталоге.

В некоторых случаях вам нужно добавить правильный путь к файлу и укажите терминал Java в правильном месте. Поскольку вы выполняете команду из терминала командной строки, компьютер не знает, где находится класс или где он находится. В целевой среде IDE это не проблема, поскольку среда IDE сохраняет указатель, указывающий на текущий рабочий каталог.

Что такое синтаксис ‘java ‘?

Прежде чем мы начнем устранять неполадки, по которым терминал возвращает нам ошибку при попытке выполнения, сначала нам нужно взглянуть на синтаксис команды. Если вы не используете правильный синтаксис, вы неизбежно столкнетесь с этой ошибкой.

Обычный синтаксис команды выглядит примерно так:

 java [  ...]  [ ...] 

Здесь – параметр командной строки, – полное имя класса Java, и – это аргумент командной строки, который передается вашему приложению при компиляции всего пакета.

Пример допустимой команды:

 java -Xmx100m  com.acme.example.ListAppuals kevin arrow bart 

Приведенная выше команда заставит java-команду выполнять следующие операции:

• Она будет искать скомпилированная версия класса ‘ com.acme.example.ListAppuals ‘.
• После поиска он загрузит класс.
• Затем, когда класс загружен, в классе будет выполняться поиск «основного» метода с действительной подписью, модификаторами и типом возвращаемого значения. Пример основного класса будет выглядеть примерно так:

 public static void main (String []) 

• Метод будет вызываться с аргументами “кевин”, “стрелки” и “барт” в виде строки [].

Как исправить ошибку “Не удалось найти или загрузить основной класс”

Решение 1. Проверка аргумента имени класса

Самая распространенная ошибка пользователей заключается в том, что они предоставляют неправильное имя класса в качестве аргумента (или правильное имя класса имеет неправильную форму). Поскольку мы объявляем параметры в командной строке, весьма вероятно, что вы передадите аргумент имени класса в неправильной форме. Здесь мы перечислим все возможные сценарии, в которых вы можете сделать ошибку.

• Написание простого имени класса . Если вы объявляете класс в пакете, таком как com.acme.example, вы должны использовать полное имя класса , включая пакет, в команде Java.

 java com.acme.example.ListAppuals 

вместо

 java ListAppuals 

• Вам следует объявить имя класса вместо объявления имени файла или пути. Java не получает класс, если вы объявляете для него путь/имя файла. Неправильные записи включают следующее:

 java ListAppuals.classjava com/acme/example/ListAppuals.class 

Следует учитывать
• Корпус . Команды Java чувствительны к регистру, и если вы ошибетесь хотя бы с одной буквой, вы не сможете загрузить основной класс. Пример неправильных ошибок :

 java com.acme.example.listappuals 

• Вы не должны объявлять исходное имя файла . Как упоминалось ранее, вам нужно только объявить класс в правильном формате полного имени класса. Пример ошибки:

 java ListAppuals.java 

• Эта ошибка также возникнет, если вы сделаете опечатка или забудьте полностью написать имя класса .

Если вы допустили небрежные ошибки при объявлении имени класса, убедитесь, что вы исправили это, а затем попробуйте запустить программу.

Решение 2. Проверка пути к классам

Если вы объявили имя класса правильно, но по-прежнему отображается ошибка, есть вероятность, что команда java не смогла найти указанное имя класса по пути. Путь к классам – это путь, по которому среда выполнения Java ищет файлы ресурсов и классов. Вы можете легко установить путь к классам, используя две разные команды, как показано ниже:

 C:> sdkTool -classpath classpath1; classpath2 ... C:> set CLASSPATH = classpath1; classpath2 ... 

Чтобы получить больше информации о пути к классам, вам следует ознакомиться со следующими документами.

Документация по командам Java

Установка пути к классам

Решение 3. Проверка каталога

Когда вы объявляете каталог как путь к классам, он всегда будет соответствовать корню пространства имен. Например, если «/usr/local/acme/classes» находится в пути к классам, тогда Java будет искать класс «com.acme.example.Appuals». Он будет искать класс со следующим путем:

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

Итак, по сути , если вы укажете следующий адрес в пути к классам, Java не сможет найти класс:

/usr/local/acme/classes/com/acme/example 

Вы также должны проверить свой подкаталог и посмотреть, соответствует ли он FQN. Если FQN вашего класса – «com.acme.example.Appuals», то Java будет искать «Appuals.class» в каталоге «com/acme/example».

Чтобы дать вам Например, предположим следующий сценарий:

• Класс, который вы хотите запустить: com.acme.example.Appuals
• полный путь к файлу :/usr/local/acme/classes/com/acme/example/Appuals.class
• текущий рабочий каталог is:/usr/local/acme/classes/com/acme/example/

Тогда будут выполняться следующие сценарии:

 # неверно,  Требуется FQN java Appuals # неверно, в текущем рабочем каталоге нет папки `com/acme/example` java com.acme.example.Appuals # неверно, аналогично приведенному выше сценарию java -classpath.  com.acme.example.Appuals # OK;  относительный путь к классам - setjava -classpath ../../.. com.acme.example.Appuals # OK;  установлен абсолютный путь к классам java -classpath/usr/local/acme/classes com.acme.example.Appuals 

Примечание. Путь к классам также должен включать все другие классы (несистемные), которые нужны вашим приложениям.

Решение 4. Проверка пакета классов

Если все вышеперечисленные решения верно в вашем случае, вам нужно убедиться, что ваш исходный код помещен в правильную папку. Кроме того, вы правильно объявили пакет . Если вы запустите свой код с IDE, он, вероятно, проинформирует вас о проблеме. Однако в нашем случае, поскольку мы запускаем его в командной строке, ошибка останется незамеченной, и вы получите обсуждаемую ошибку класса.

Синтаксис команды java <class-name>

Прежде всего, вам необходимо понять, как правильно запустить программу с помощью команды java (или javaw).

Обычный синтаксис ¹ таков:

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

где <option> — это параметр командной строки (начинающийся с символа «-«), <class-name> — это полное имя класса Java, а <argument> — произвольный аргумент командной строки, который передается вашему приложению.
^{1 — есть второй синтаксис для «исполняемых» JAR файлов, который я опишу внизу.}

Полное имя (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 — вы ошиблись с аргументом имени класса

Первой вероятной причиной является то, что вы, возможно, указали неправильное имя класса. (Или… правильное имя класса, но в неправильной форме.) Рассматривая приведенный выше пример, можно привести множество неправильных способов указания имени класса:

• Пример № 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 ListUser.java
  

• Пример №6 — вы полностью забыли имя класса

  java lots of arguments
  

Причина № 2 — неверно указан путь к классу приложения

Вторая вероятная причина состоит в том, что имя класса является правильным, но команда java не может найти класс. Чтобы понять это, вам необходимо понять концепцию «classpath». Это хорошо объясняется документацией Oracle:

• Документация по командам java
• Установка пути к классам.
• Учебник по Java — PATH и CLASSPATH

Итак… если вы правильно указали имя класса, то следует проверить, правильно ли вы указали путь к классам:

1. Прочитайте три документа, ссылки на которые приведены выше. (Да… ПРОЧИТАЙТЕ их. Важно, чтобы программист Java понимал, по крайней мере, основы того, как работают механизмы пути классов Java.)
2. Посмотрите на командную строку и/или переменную среды CLASSPATH, которая действует, когда вы запускаете команду java. Проверьте правильность имен каталогов и файлов JAR.
3. Если в пути к классам есть относительные имена путей, проверьте, правильно ли они разрешаются… из текущего каталога, действующего при запуске команды java.
4. Убедитесь, что класс (упомянутый в сообщении об ошибке) может быть расположен на эффективном пути к классам.
5. Обратите внимание, что синтаксис пути к классам отличается для Windows по сравнению с Linux и Mac OS. (Сепаратор пути к классам ; на Windows, и : на других Если вы используете неправильный разделитель для вашей платформы, вы не получите сообщение об ошибке явного Вместо этого, вы получите несуществующий файл или каталог на пути, который будет.. молча игнорируется.)

Причина № 2а — неправильный каталог находится на пути к классам

Когда вы помещаете каталог в путь к классам, он условно соответствует корню квалифицированного пространства имен. Классы расположены в структуре каталогов под этим корнем, сопоставляя полное имя с путевым именем. Так, например, если «/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 будет искать «Foon.class» в каталоге «com/acme/example»:

• Если ваша структура каталогов не соответствует именам пакетов, как показано выше, JVM не найдет ваш класс.

• Если вы попытаетесь переименовать класс, переместив его, это тоже не удастся… но трассировка стека исключений будет другой.

Чтобы привести конкретный пример, предположим, что:

• вы хотите запустить класс 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

Заметки:

• Опция -classpath может быть сокращена до -cp в большинстве выпусков Java. Проверьте соответствующие ручные записи для java, javac и так далее.
• Тщательно продумайте выбор между абсолютными и относительными путями в classpath. Помните, что относительный путь может «сломаться», если текущий каталог изменится.

Причина № 2c — зависимости отсутствуют в пути к классам

Путь к классам должен включать все другие (не системные) классы, от которых зависит ваше приложение. (Системные классы располагаются автоматически, и вам редко нужно беспокоиться об этом.) Для корректной загрузки основного класса JVM должна найти:

• сам класс.
• все классы и интерфейсы в иерархии суперклассов (например, см. класс Java присутствует в пути к классам, но запуск завершается неудачно с ошибкой: не удалось найти или загрузить основной класс)
• все классы и интерфейсы, на которые ссылаются с помощью объявления переменных или переменных, либо вызова метода или выражений доступа к полю.

(Примечание: спецификации JLS и JVM позволяют некоторой области для JVM загружать классы «лениво», и это может повлиять, когда выдается исключение загрузчика классов.)

Причина № 3 — класс был объявлен в неправильной упаковке

Иногда случается, что кто-то помещает файл исходного кода в неправильную папку в своем дереве исходного кода, или они package объявление package. Если вы сделаете это в IDE, компилятор IDE немедленно сообщит вам об этом. Точно так же, если вы используете достойный инструмент для сборки Java, он будет запускать javac таким образом, чтобы выявлять проблему. Однако, если вы создаете свой Java-код вручную, вы можете сделать это таким образом, чтобы компилятор не заметил проблему, и полученный файл «.class» оказался не там, где вы ожидаете.

Все еще не можете найти проблему?

Есть много вещей, которые можно проверить, и что-то легко пропустить. Попробуйте добавить -Xdiag в командную строку java (как первое после java). Он будет выводить различные вещи о загрузке классов, и это может дать вам подсказки о том, какова реальная проблема.

Также рассмотрите возможные проблемы, вызванные копированием и вставкой невидимых или не-ASCII символов с веб-сайтов, документов и так далее. И рассмотрим «гомоглифы», если две буквы или символы выглядят одинаково… но это не так.

---

java -jar <jar file>

Альтернативный синтаксис, используемый для «исполняемых» файлов JAR, выглядит следующим образом:

  java [ <option> ... ] -jar <jar-file-name> [<argument> ...]

например

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

В этом случае имя класса точки входа (т.е. com.acme.example.ListUser) и com.acme.example.ListUser классу указываются в MANIFEST файла JAR.

---

Иды

Типичная среда Java IDE поддерживает запуск приложений Java в самой JVM IDE или в дочерней JVM. Они, как правило, защищены от этого конкретного исключения, поскольку в среде IDE используются собственные механизмы для создания пути к классам среды выполнения, определения основного класса и создания командной строки java.

Однако это исключение по-прежнему возможно, если вы делаете что-то за спиной IDE. Например, если вы ранее настроили Application Launcher для своего Java-приложения в Eclipse, а затем переместили файл JAR, содержащий класс «main», в другое место файловой системы, не сообщая Eclipse, Eclipse невольно запустит JVM с неправильным путем к классу.

Короче говоря, если вы столкнулись с этой проблемой в IDE, проверьте наличие таких вещей, как устаревшее состояние IDE, неработающие ссылки на проекты или неработающие конфигурации запуска.

Для IDE также возможно просто запутаться. IDE — это чрезвычайно сложные части программного обеспечения, состоящие из множества взаимодействующих частей. Многие из этих частей используют различные стратегии кэширования, чтобы сделать среду IDE в целом отзывчивой. Иногда они могут пойти не так, и одним из возможных симптомов являются проблемы при запуске приложений. Если вы подозреваете, что это может произойти, стоит перезапустить вашу IDE.

---

Другие ссылки

• Из Oracle Java Tutorials — Распространенные проблемы (и их решения)

Популярное сообщение об ошибке для новых пользователей Java.

Error: Could not find or load main class ClassName.class
Caused by: java.lang.ClassNotFoundException: ClassName.class

1. Нет пакета

1.1 Обзоры простой Java Hello World, без пакета.

C: /projects/HelloWorld.java

public class HelloWorld {

public static void main(String[] args) {

System.out.println("Hello World");

}

}

Терминал

# Compile Java source code
C:projects> javac HelloWorld.java

C:projects> dir
15/04/2019  01:20 PM               425 HelloWorld.class
15/04/2019  01:42 PM               138 HelloWorld.java

# Run Java
C:projects>java HelloWorld.class
Error: Could not find or load main class HelloWorld.class
Caused by: java.lang.ClassNotFoundException: HelloWorld.class

Чтобы исправить это, запустите java ClassName без .class расширение.

Терминал

C:projects>java HelloWorld
Hello World

2. С пакетом

2.1 Простой Hello World и package это так же как com.mkyong

C: /projects/HelloWorld.java

package com.mkyong;

public class HelloWorld {

public static void main(String[] args) {

System.out.println("Hello World");

}

}

Терминал

# Compile Java source code
C:projects> javac HelloWorld.java

C:projects> dir
15/04/2019  01:20 PM               425 HelloWorld.class
15/04/2019  01:42 PM               138 HelloWorld.java

C:projects>java HelloWorld
Error: Could not find or load main class HelloWorld
Caused by: java.lang.NoClassDefFoundError: com/mkyong/HelloWorld (wrong name: HelloWorld)

2.2 Если package определяется, классы Java .class должен разместить в правильном месте папки.

Например :

C: /projects/HelloWorld.java

package com.mkyong;

Выше сгенерированный файл класса должен поместить в C:projectscommkyongHelloWorld.class

2.3 Чтобы исправить это , мы можем использовать -d указать, где разместить сгенерированные файлы классов.

Терминал

# Compile Java source code
C:projects> javac -d . HelloWorld.java

C:projects> dir

15/04/2019  02:01 PM              com
15/04/2019  01:51 PM               161 HelloWorld.java

C:projectscommkyongHelloWorld.class
C:projectsHelloWorld.java

2.4 Теперь мы можем бежать так java {package}.HelloWorld

Терминал

C:projects>java HelloWorld
Error: Could not find or load main class HelloWorld
Caused by: java.lang.ClassNotFoundException: HelloWorld

C:projects>java com.csharpcoderr.HelloWorld
Hello World

Рекомендации

• Википедия — пакет Java

распространенная ошибка Java