Wednesday, February 8, 2012

How to fix java.lang.ClassNotFoundException: org.apache.commons.logging.LogFactory

java.lang.ClassNotFoundException: org.apache.commons.logging.LogFactory  or "Exception in thread "main" java.lang.NoClassDefFoundError: org/apache/commons/logging/LogFactory" exception comes when you don't apache commons-logging-1.1.1.jar in your Classpath. I have faced this exception many times while using open source framework like Struts, Spring and Displaytag which uses commons-logging framework for logging. commons-logging is not an actual java logging framework but provides a wrapper so that you can use log4j, java logging or any other Java logging framework. commons-logging is also smart enough to detect which logging framework are you using e.g if you are using log4j it can detect it by looking log4j.jar in your classpath. but if you don't have commons-logging.jar in your classpath you may get java.lang.ClassNotFoundException: org.apache.commons.logging.LogFactory at runtime even if your application gets deployed successfully.

Cause of java.lang.ClassNotFoundException: org.apache.commons.logging.LogFactory

java.lang.ClassNotFoundException: org.apache.commons.logging.LogFactory ErrorReal cause of "Exception in thread "main" java.lang.NoClassDefFoundError: org/apache/commons/logging/LogFactory" or "java.lang.ClassNotFoundException: org.apache.commons.logging.LogFactory" is JVM not able to locate commons-logging-1.1.1.jar in classpath but it may surface differently on different environment. Some time even you get this error even if you already have commons-logging-1.1.1.jar in classpath and many times it different reasons for different environment. It gets more difficult on managed environment like J2EE web servers and application servers where different classloader loads different classes e.g. AppClassLoader is responsible for loading web application but classes inside lib directory of web server e.g. tomcat is loaded by another classloader. So you can also get "java.lang.ClassNotFoundException: org.apache.commons.logging.LogFactory" if commons-logging.jar is not visible to App classloader. some times this jar can also cause memory leak in tomcat.

here I have outlined some steps to fix "java.lang.ClassNotFoundException: org.apache.commons.logging.LogFactory" these are based on approach I used to resolve such kind of error. it may help you as well.

java.lang.ClassNotFoundException: org.apache.commons.logging.LogFactory Solution

1.Check your classpath for commons-logging-1.1.1.jar, if you are using spring MVC and working in web application it
must be on /WEB-INF/lib directory.

2.Check if your Java program has sufficient permission to access that jar file (I faced this issue in Unix machine
when user who copied that jar does override the default permission and application was not able to read this jar file
so make sure to check permissions if you are copying commons-logging-1.1.1.jar into Java Classpath.

3.See if commons-logging-1.1.1.jar contains org.apache.commons.logging.LogFactory class or not this may happen if commons-logging-1.1.1.jar is corrupt or not downloaded completely or may be downloaded from incorrect source.

4.See if your Classpath is getting overridden by any start-up Script as suggested on my post how to solve java.lang.ClassNotFoundException

5.If you are using maven for managing dependency on your project than check if your pom.xml file contains following
entry or not and if it doesn't than include following dependency for commons-logging-1.1.1.jar in pom.xml:
Maven dependency for Apache commons-logging:


That's all on How to fix java.lang.ClassNotFoundException: org.apache.commons.logging.LogFactory Error, it may surface as "Exception in thread "main" java.lang.NoClassDefFoundError: org/apache/commons/logging/LogFactory" also but mostly cause of both errors are same. If you have any other useful step to figure out ClassNotFoundException suggest it here.

Further Learning
Understanding the Java Virtual Machine: Class Loading and Reflection
Java Performance The Definitive Guide By Scott Oaks
Understanding and Solving Java Memory Problems

Here are few more Java tutorials you may like.


Amit Bhargava said...

Not quite a question on this article, but here goes.

I've got a common.jar file that I build using maven and store in my local repository so that i can build other modules. Is there any way I can delete previous versions of the jar while storing it in repository?

Hugo Prudente said...

Tks Brow.
I use this solution, to check my commons-loggin*.jar. They didn't go to web-inf/lib folder.

So i delete my target folder from my javaee project and clean/build again my solution, i restart my server and make the new deploy and works.


Ankur said...

Hi , I have query ::

I am looking to fix an java.lang.ClassNotFoundException: com.reportmill.shape.RMShape .

I am unable to find the solution.

Plz help me>:)

Anonymous said...

I a getting Exception in thread "main" java.lang.NoClassDefFoundError: org/apache/commons/logging/LogFactory
at org.springframework.context.annotation.AnnotationConfigApplicationContext.(
at org.springframework.context.annotation.AnnotationConfigApplicationContext.(
at hello.Application.main(
Caused by: java.lang.ClassNotFoundException: org.apache.commons.logging.LogFactory
at$ Source)
at Method)
at Source)
at java.lang.ClassLoader.loadClass(Unknown Source)
at sun.misc.Launcher$AppClassLoader.loadClass(Unknown Source)
at java.lang.ClassLoader.loadClass(Unknown Source)
... 5 more

while working with spring 4.2.1 version and annotation drive application context. which JAR should I add into claspath?

Post a Comment