306

I've tried both the examples in Oracle's Java Tutorials. They both compile fine, but at run time, both come up with this error:

Exception in thread "main" java.lang.NoClassDefFoundError: graphics/shapes/Square
    at Main.main(Main.java:7)
Caused by: java.lang.ClassNotFoundException: graphics.shapes.Square
    at java.net.URLClassLoader$1.run(URLClassLoader.java:366)
    at java.net.URLClassLoader$1.run(URLClassLoader.java:355)
    at java.security.AccessController.doPrivileged(Native Method)
    at java.net.URLClassLoader.findClass(URLClassLoader.java:354)
    at java.lang.ClassLoader.loadClass(ClassLoader.java:424)
    at sun.misc.Launcher$AppClassLoader.loadClass(Launcher.java:308)
    at java.lang.ClassLoader.loadClass(ClassLoader.java:357)
    ... 1 more

I think I might have the Main.java file in the wrong folder.

Here is the directory hierarchy:

graphics
├ Main.java
├ shapes
|   ├ Square.java
|   ├ Triangle.java
├ linepoint
|   ├ Line.java
|   ├ Point.java
├ spaceobjects
|   ├ Cube.java
|   ├ RectPrism.java

And here is Main.java:

import graphics.shapes.*;
import graphics.linepoint.*
import graphics.spaceobjects.*;

public class Main {
    public static void main(String args[]) {
        Square s = new Square(2, 3, 15);
        Line l = new Line(1, 5, 2, 3);
        Cube c = new Cube(13, 32, 22);
    }
}

What am I doing wrong here?

UPDATE

After I put put the Main class into the graphics package (I added package graphics; to it), set the classpath to "_test" (folder containing graphics), compiled it, and ran it using java graphics.Main (from the command line), it worked.

Really late UPDATE #2

I wasn't using Eclipse (just Notepad++ and the JDK), and the above update solved my problem. However, it seems that many of these answers are for Eclipse and IntelliJ IDEA, but they have similar concepts.

11
  • 1
    Looking at your main class, it is not in a package (you would have package graphics; at the top). Is graphics the head of your package structure? Does Square have package graphics.shapes at the top?
    – lreeder
    Commented Jul 31, 2013 at 15:07
  • 1
    You're listing where the .java files are, but since what you're getting is a runtime issue, what you're actually interested in is where the .class files are and whether they are on your classpath or not. How are you executing the Main class?
    – Vala
    Commented Jul 31, 2013 at 15:07
  • Just hit Shift+ctrl+o in eclipse to organize your imports Commented Jul 31, 2013 at 15:13
  • Make sure that you type the class name correctly. I was getting this error because I didn't start the class name with an upper case letter Commented Feb 14, 2014 at 22:53
  • This sometimes occur in IntelliJ IDEA after a major refactoring. Right click on your project and select -> Compile Module, and then re-start the project and it should work again.
    – Zar
    Commented Feb 23, 2014 at 17:14

34 Answers 34

302

After you compile your code, you end up with .class files for each class in your program. These binary files are the bytecode that Java interprets to execute your program. The NoClassDefFoundError indicates that the classloader (in this case java.net.URLClassLoader), which is responsible for dynamically loading classes, cannot find the .class file for the class that you're trying to use.

Your code wouldn't compile if the required classes weren't present (unless classes are loaded with reflection), so usually this exception means that your classpath doesn't include the required classes. Remember that the classloader (specifically java.net.URLClassLoader) will look for classes in package a.b.c in folder a/b/c/ in each entry in your classpath. NoClassDefFoundError can also indicate that you're missing a transitive dependency of a .jar file that you've compiled against and you're trying to use.

For example, if you had a class com.example.Foo, after compiling you would have a class file Foo.class. Say for example your working directory is .../project/. That class file must be placed in .../project/com/example, and you would set your classpath to .../project/.

Side note: I would recommend taking advantage of the amazing tooling that exists for Java and JVM languages. Modern IDEs like Eclipse and IntelliJ IDEA and build management tools like Maven or Gradle will help you not have to worry about classpaths (as much) and focus on the code! That said, this link explains how to set the classpath when you execute on the command line.

2
  • 2
    I'm reading this because of an error I encountered while trying to run a unit test on Android. It turns out that the NoClassDefFoundError, in my case, occurred as a result of missing dependencies in the test. I need to think about dependency injection to prevent errors like this. Thanks for the elaborate answer.
    – danmaze
    Commented May 30, 2020 at 9:43
  • I got this error due to setting FormLayout(JGoodies) for layout setting of a Form. Which means there are issues with that class library to be fixed. Yet it appears in layout list of a Form in IntelliJ.
    – bunkinet
    Commented Sep 11, 2021 at 6:41
166

I'd like to correct the perspective of others on NoClassDefFoundError.

NoClassDefFoundError can occur for multiple reasons like:

  1. ClassNotFoundException -- .class not found for that referenced class irrespective of whether it is available at compile time or not(i.e base/child class).
  2. Class file located, but Exception raised while initializing static variables
  3. Class file located, Exception raised while initializing static blocks

In the original question, it was the first case which can be corrected by setting CLASSPATH to the referenced classes JAR file or to its package folder.

What does it mean by saying "available in compile time"?

  • The referenced class is used in the code.
    E.g.: Two classes, A and B (extends A). If B is referenced directly in the code, it is available at compile time, i.e., A a = new B();

What does it mean by saying "not available at compile time"?

  • The compile time class and runtime class are different, i.e., for example base class is loaded using classname of child class for example Class.forName("classname") E.g.: Two classes, A and B (extends A). Code has
    A a = Class.forName("B").newInstance();
7
  • In my case, I had compiled a class, them moved it to a directory called app. I had to add a line with package app; and recompile before I could move it into the subdirectory app.
    – taco
    Commented Sep 7, 2014 at 18:07
  • 1
    Apart from above listed 3, ClassLoaders also may cause the such error, which is basically ClassNotFoundException, in this scenario class may present in classpath but attempt to load from different ClassLoader
    – Fahad
    Commented Nov 6, 2015 at 13:47
  • 2 and 3 are classloader-specific. According to the javadoc, the exception is only intended for reason 1.
    – Samuel
    Commented Mar 29, 2016 at 23:44
  • 1
    I have tested the case 2 and case 3, it' not NoClassDefFoundError, it's ExceptionInInitializerError Case 2.Class file located, but Exception raised while initializing static variables Case 3.Class file located, Exception raised while initializing static blocks
    – Michael
    Commented Jan 13, 2017 at 3:52
  • 1
    @Michael, This link says that your stacktrace will too show NoClassDefFoundError for that case: archive.is/YPbYI#selection-2107.0-2115.13
    – Pacerier
    Commented Dec 10, 2017 at 7:17
25

If you got one of these errors while compiling and running:

  • NoClassDefFoundError

  • Error: Could not find or load main class hello

  • Exception in thread "main" java.lang.NoClassDefFoundError:javaTest/test/hello (wrong name: test/hello)

    at java.lang.ClassLoader.defineClass1(Native Method)
    at java.lang.ClassLoader.defineClass(Unknown Source)
    at java.security.SecureClassLoader.defineClass(Unknown Source)
    at java.net.URLClassLoader.defineClass(Unknown Source)
    at java.net.URLClassLoader.access$100(Unknown Source)
    at java.net.URLClassLoader$1.run(Unknown Source)
    at java.net.URLClassLoader$1.run(Unknown Source)
    at java.security.AccessController.doPrivileged(Native Method)
    at java.net.URLClassLoader.findClass(Unknown Source)
    at java.lang.ClassLoader.loadClass(Unknown Source)
    at sun.misc.Launcher$AppClassLoader.loadClass(Unknown Source)
    at java.lang.ClassLoader.loadClass(Unknown Source)
    at sun.launcher.LauncherHelper.checkAndLoadMain(Unknown Source)
    

-------------------------- Solution -----------------------

The problem is mostly in packages organization. You should arrange your classes in folders properly regarding to the package classifications in your source code.

On compiling process, use this command:

javac -d . [FileName.java]

To run the class, please use this command:

java [Package].[ClassName]
3
  • 1
    The "-d ." in javac command does the trick, creating the folder structure of the packages instead of putting all the .class files on the root directory, thanks! Commented Jul 15, 2019 at 16:21
  • 1
    Thank you, Sr. That solves the error for compiling. Commented Aug 24, 2021 at 4:33
  • Where do the .class files end up when compiling this way?
    – Junglemath
    Commented Apr 30 at 13:11
21

One possible reason for this NoClassDefFoundError might be that the class is present in the classpath at Compile time, but it doesn't exist in the classpath at Runtime.

If you're using Eclipse, make sure you have the shapes, linepoints and the spaceobjects as entries in the .classpath file.

2
  • 1
    How to handle that in runtime via try/catch?
    – Maveňツ
    Commented Feb 13, 2017 at 6:54
  • 11
    This answer is not correct the way you write it. Correct would be: "ONE possible cause of this error is...." But there may be other reasons why you get this error for example when loading a JAR file at runtime with a classloader.
    – Elmue
    Commented Feb 23, 2017 at 3:54
12
java.lang.NoClassDefFoundError

indicates that something was found at compile time, but not at run time. Maybe you just have to add it to the classpath.

1
  • depends on the context you are asking for.
    – sschrass
    Commented Dec 6, 2016 at 10:47
10

NoClassDefFoundError in Java:

Definition:

NoClassDefFoundError will come if a class was present during compile time but not available in java classpath during runtime. Normally you will see below line in log when you get NoClassDefFoundError: Exception in thread "main" java.lang.NoClassDefFoundError

Possible Causes:

  1. The class is not available in Java Classpath.

  2. You might be running your program using jar command and class was not defined in manifest file's ClassPath attribute.

  3. Any start-up script is overriding Classpath environment variable.

  4. Because NoClassDefFoundError is a subclass of java.lang.LinkageError it can also come if one of it dependency like native library may not available.

  5. Check for java.lang.ExceptionInInitializerError in your log file. NoClassDefFoundError due to the failure of static initialization is quite common.

  6. If you are working in J2EE environment than the visibility of Class among multiple Classloader can also cause java.lang.NoClassDefFoundError, see examples and scenario section for detailed discussion.

Possible Resolutions:

  1. Verify that all required Java classes are included in the application’s classpath. The most common mistake is not to include all the necessary classes, before starting to execute a Java application that has dependencies on some external libraries.

  2. The classpath of the application is correct, but the Classpath environment variable is overridden before the application’s execution.

  3. Verify that the aforementioned ExceptionInInitializerError does not appear in the stack trace of your application.

Resources:

3 ways to solve java.lang.NoClassDefFoundError in Java J2EE

java.lang.NoClassDefFoundError – How to solve No Class Def Found Error

9

The no class definition exception occurs when the intended class is not found in the class path.

At compile time class: Class was generated from the Java compiler, but somehow at run time the dependent class is not found.

Let’s go through one simple example:

public class ClassA{
    public static void main(String args[]){
         // Some gibberish code...
         String text = ClassB.getString();
         System.out.println("Text is: " + text);
    }
}

public class ClassB{
    public static String getString(){
        return "Testing some exception";
    }
}

Now let's assume that the above two Java source code are placed in some folder, let's say "NoClassDefinationFoundExceptionDemo"

Now open a shell (assuming Java is already being set up correctly)

  1. Go to folder "NoClassDefinationFoundExceptionDemo"

  2. Compile Java source files javac ClassB javac ClassA

  3. Both files are compiled successfully and generated class files in the same folder as ClassA.class and ClassB.class

  4. Now since we are overriding ClassPath to the current working director, we execute the following command java -cp . ClassA and it worked successfully and you will see the output on the screen

  5. Now let's say, you removed ClassB.class file from the present directory. And now you execute the command again. java -cp . ClassA Now it will greet you with NoClassDefFoundException. As ClassB which is a dependency for ClassA is not found in the classpath (i.e., the present working directory).

4

If your project is in a package like com.blahcode and your class is called Main, the compiled files may be output in a directory structure like ./out/com/blahcode/Main.class. This is especially true for IntelliJ IDEA.

When trying to run from a shell or cmd, you need to cd to that which contains com as a sub-directory.

cd out
java -classpath . com.blahcode.Main
3

If you are "starting" a class from a JAR file, make sure to start with the JAR full path. For example, (if your "main class" is not specified in Manifest):

java -classpath "./dialer.jar" com.company.dialer.DialerServer

And if there are any dependencies, such dependencies to other JAR files, you can solve such a dependency

  • either by adding such JAR files (full path to each JAR file) to the class path. For example,
java -classpath "./libs/phone.jar;./libs/anotherlib.jar;./dialer.jar" com.company.dialer.DialerServer
  • or by editing the JAR manifest by adding "dependency JAR filess" to the manifest. Such a manifest file might look like:
Manifest-Version: 1.0
Class-Path: phone.jar anotherlib.jar
Build-Jdk-Spec: 1.8
Main-Class: com.company.dialer.DialerServer
  • or (if you are a developer having source code) you can use Maven to prepare a manifest for you by adding to the *.pom file:
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-jar-plugin</artifactId>
    <configuration>
        <archive>
            <manifest>
                <addClasspath>true</addClasspath>
                <mainClass>com.company.dialer.DialerServer</mainClass>
                <!-- Workaround for Maven bug #MJAR-156 (https://jira.codehaus.org/browse/MJAR-156) -->
                <useUniqueVersions>false</useUniqueVersions>
            </manifest>
        </archive>
    </configuration>
</plugin>

Please note that the above example uses ; as a delimiter in classpath (it is valid for the Windows platform). On Linux, replace ; by :.

For example,

java -classpath ./libs/phone.jar:./libs/anotherlib.jar:./dialer.jar
com.company.dialer.DialerServer
2

I have faced with the problem today. I have an Android project and after enabling multidex the project wouldn't start anymore.

The reason was that I had forgotten to call the specific multidex method that should be added to the Application class and invoked before everything else.

 MultiDex.install(this);

Follow this tutorial to enable multidex correctly. https://developer.android.com/studio/build/multidex.html

You should add these lines to your Application class

 @Override
  protected void attachBaseContext(Context base) {
     super.attachBaseContext(base);
     MultiDex.install(this);
  }
2

After working on a NetBeans project for many months, I suddenly got the NoClassDefFoundError message shortly after getting a "Low Memory" alert. Doing a Clean rebuild didn't help, but closing NetBeans altogether and reopening the project there were no error reports.

2

This answer is specific to a java.lang.NoClassDefFoundError happening in a service:

My team recently saw this error after upgrading an rpm that supplied a service. The rpm and the software inside of it had been built with Maven, so it seemed that we had a compile time dependency that had just not gotten included in the rpm.

However, when investigating, the class that was not found was in the same module as several of the classes in the stack trace. Furthermore, this was not a module that had only been recently added to the build. These facts indicated it might not be a Maven dependency issue.

The eventual solution: Restart the service!

It appears that the rpm upgrade invalidated the service's file handle on the underlying JAR file. The service then saw a class that had not been loaded into memory, searched for it among its list of jar file handles, and failed to find it because the file handle that it could load the class from had been invalidated. Restarting the service forced it to reload all of its file handles, which then allowed it to load that class that had not been found in memory right after the rpm upgrade.

2
  • What is "rpm"? Is it related to package management on Red Hat Linux? Or something else? Commented May 26, 2021 at 10:37
  • @PeterMortensen It stands for Red Hat Package Manager, although recently they've employed recursive naming to call it just RPM Package Manager. Commented Jul 6, 2021 at 14:02
2

For my project, what solved the issue was that Chrome browser and chromedriver were not compatibles. I had a very old version of the driver that could not even open the browser. I just downloaded the latest version of both and problem solved.

How did I discover the issue? Because I ran my project using the Selenium native Firefox driver with an old version of FF included with my application. I realized the problem was incompatibility between browser and driver.

Hope this can help anyone with a similar issue as mine, that generated this same Error Message.

1

I'm developing an Eclipse based application also known as RCP (Rich Client Platform). And I have been facing this problem after refactoring (moving one class from an plugIn to a new one).

Cleaning the project and Maven update didn't help.

The problem was caused by the Bundle-Activator which haven't been updated automatically. Manual update of the Bundle-Activator under MANIFEST.MF in the new PlugIn has fixed my problem.

1

If you are using more than one module, you should have

dexOptions {
    preDexLibraries = false
}

in your build file.

1

I had the same issue with my Android development using Android studio. Solutions provided are general and did not help me (at least for me).

After hours of research, I found the following solution and it may help to Android developers who are doing development using Android Studio.

Modify the setting as below:

PreferencesBuild, Execution, DeploymentInstant Run → *uncheck the first option.

With this change I am up and running.

0

My two cents in this chain:

Ensure that the classpath contains full paths (/home/user/lib/some_lib.jar instead of ~/lib/some_lib.jar) otherwise you can still face NoClassDefFoundError error.

1
  • This is true in part, but it is more complicated. 1) You can use relative paths in the classpath, but they must be resolvable by the JVM ... relative to the JVM's current directory. This makes them fragile. 2) You can use ~ and other shell meta characters when setting a classpath environment variable, but only provided the mechanism you are using to set the variable expands them to real pathnames. If you are using bash, you can get "mixed" results. For example, look at what you get when you type echo ~:~ on the command line. The first ~ is expanded, but the second isn't.
    – Stephen C
    Commented Mar 31, 2019 at 9:38
0

Don't use test classes outside the module

I do not have a solution, just another flavour of the "present at compilation, absent at run time" case.

I was trying to use a very convenient method from a JUnit test class from another test class which resides in a different module. That's a no-no, since test code is not part of the packaged jar, but I didn't realize because it appears visible for the user class from within Eclipse.

My solution was to place the method in a existing utilities class that is part of the production code.

0

I get NoClassFoundError when classes loaded by the runtime class loader cannot access classes already loaded by the Java rootloader. Because the different class loaders are in different security domains (according to Java) the JVM won't allow classes already loaded by the rootloader to be resolved in the runtime loader address space.

Run your program with 'java -javaagent:tracer.jar [YOUR 'java' ARGUMENTS]'

It produces output showing the loaded class, and the loader environment that loaded the class. It's very helpful tracing why a class cannot be resolved.

// ClassLoaderTracer.java
// From: https://blogs.oracle.com/sundararajan/entry/tracing_class_loading_1_5

import java.lang.instrument.*;
import java.security.*;

// manifest.mf
// Premain-Class: ClassLoadTracer

// jar -cvfm tracer.jar manifest.mf ClassLoaderTracer.class

// java -javaagent:tracer.jar  [...]

public class ClassLoadTracer
{
    public static void premain(String agentArgs, Instrumentation inst)
    {
        final java.io.PrintStream out = System.out;
        inst.addTransformer(new ClassFileTransformer() {
            public byte[] transform(ClassLoader loader, String className, Class classBeingRedefined, ProtectionDomain protectionDomain, byte[] classfileBuffer) throws IllegalClassFormatException {

                String pd = (null == protectionDomain) ? "null" : protectionDomain.getCodeSource().toString();
                out.println(className + " loaded by " + loader + " at " + new java.util.Date() + " in " + pd);

                // dump stack trace of the thread loading class
                Thread.dumpStack();

                // we just want the original .class bytes to be loaded!
                // we are not instrumenting it...
                return null;
            }
        });
    }
}
0

It happened to me in Android Studio.

The solution that worked for me: just restart Android Studio.

0

Check that if you have a static handler in your class. If so, please be careful, cause static handler only could be initiated in thread which has a looper, the crash could be triggered in this way:

  1. Firstly, create the instance of class in a simple thread and catch the crash.

  2. Then call the field method of Class in main thread, you will get the NoClassDefFoundError.

Here is the test code:

public class MyClass{
       private static  Handler mHandler = new Handler();
       public static int num = 0;
}

In your onCreate method of the Main activity, add the test code part:

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    //test code start
    new Thread(new Runnable() {
        @Override
        public void run() {
            try {
                MyClass myClass = new MyClass();
            } catch (Throwable e) {
                e.printStackTrace();
            }
        }
    }).start();

    try {
        Thread.sleep(1000);
    } catch (InterruptedException e) {
        e.printStackTrace();
    }
    MyClass.num = 3;
    // end of test code
}

There is a simple way to fix it using a handlerThread to the init handler:

private static Handler mHandler;
private static HandlerThread handlerThread = new HandlerThread("newthread");
static {
    handlerThread.start();
    mHandler = new Handler(handlerThread.getLooper(), mHandlerCB);
}
0
0

One source of error for this exception could stem from inconsistent definitions for Proguard, e.g. a missing

-libraryJars "path.to.a.missing.jar.library".

This explains why compilation and running works fine, given that the JAR file is there, while clean and build fails. Remember to define the newly added JAR libraries in the ProGuard setup!

Note that error messages from ProGuard are really not up to standard, as they are easily confused with similar Ant messages arriving when the JAR file is not there at all. Only at the very bottom will there be a small hint of ProGuard in trouble. Hence, it is quite logical to start searching for traditional classpath errors, etc., but this will be in vain.

Evidently, the NoClassDefFound exception will be the results when running, e.g., the resulting executable JAR file built and based on a lack of ProGuard consistency. Some call it ProGuard "Hell".

0

I use the FileSync plugin for Eclipse, so I can live debug on Tomcat. I received NoClassFoundError, because I had added a sync entry for the bin directory in the Eclipse workspace => classes in the metadata for Tomcat, but I hadn't also added a folder sync for the extlib directory in Eclipse =>

C:\Users\Stuart\eclipse-workspace\.metadata\.plugins\org.eclipse.wst.server.core\tmp0\webapps\myApp\WEB-INF\lib

0

If you recently added multidex support in Android Studio like this:

// To support MultiDex
implementation 'com.android.support:multidex:1.0.1'

So your solution is just extend from MultiDexApplication instead of Application:

public class MyApp extends MultiDexApplication {
0

In my environment, I encountered this issue in a unit test. After appending one library dependency to *.pom, that's fixed.

Example:

Error message:

java.lang.NoClassDefFoundError: com/abc/def/foo/xyz/Iottt

POM content:

<dependency>
    <groupId>com.abc.def</groupId>
    <artifactId>foo</artifactId>
    <scope>test</scope>
</dependency>
0

I got this error after a Git branch change. For the specific case of Eclipse, there were missed lines in the .settings directory for the org.eclipse.wst.common.component file. As you can see below.

Restoring the project dependencies with Maven install would help.

Enter image description here

0

If you are using gradlew, go to ./gradle/wrapper/gradle-wrapper.properties and change distributionUrl to the correct version of Gradle.

If you are using JDK14, try:

distributionUrl=https\://services.gradle.org/distributions/gradle-6.3-bin.zip
0

For Meteor or Cordova users,

It can be caused by the Java version you use. For Meteor and Cordova, stick with version 8 for now.

  1. Check available Java versions /usr/libexec/java_home -V and look for the path name for Java version 8

  2. Set the path for Java version 8 export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_191.jdk/Contents/Home

  3. Check if it is done echo $JAVA_HOME

Go on and continue coding.

0

The Java 11 + Eclipse solution:

This solution is for you if you are not using module-info.java in your Eclipse project, and you added the JAR files manually instead of using Maven/Gradle.

  1. Right click project → Build pathConfigure build pathlibraries tab
  2. Remove the problematic JAR file from the modulepath
  3. Add the JAR file to the classpath

More information is in In Eclipse, what is the difference between modulepath and classpath?.

0

I deleted the folder "buid" and "out", and the IDE rebuild again this folders with updated content files.

Not the answer you're looking for? Browse other questions tagged or ask your own question.