解决web项目运行出现java.lang.NoClassDefFoundError: org/apache/commons/logging/LogFactory

前言

在使用Tomcat作为Web服务器部署Java Web应用时，我们可能会遇到各种依赖相关的错误。本文将分享一个常见的依赖错误及其彻底的解决办法。

错误描述

在运行Tomcat时，遇到了以下错误信

org/apache/commons/logging/LogFactory
Caused by: java.lang.ClassNotFoundException: org.apache.commons.logging.LogFactory

这个错误表明Tomcat在运行时无法找到Apache Commons Logging库中的 LogFactory 类。

错误分析

Apache Commons Logging是一个常用的日志工具库，许多Java应用和库都依赖于它。当应用中使用了这个库，但没有在项目的classpath中正确添加相应的jar包时，就会出现上述错误。

解决方案

添加依赖

要解决这个问题，需要在项目的classpath中添加Apache Commons Logging的jar包。以下是几种常见的添加依赖的方法：

1. Maven项目：在 pom.xml 文件中添加以下依赖：

   <dependency>
       <groupId>commons-logging</groupId>
       <artifactId>commons-logging</artifactId>
       <version>1.0.4</version>
   </dependency>

2. Gradle项目：在 build.gradle 文件中添加以下依赖：

   dependencies {
       implementation 'commons-logging:commons-logging:1.0.4'
   }

3. 手动添加：将 commons-logging-1.0.4.jar 文件放入项目的 WEB-INF/lib 目录下。

验证依赖

添加依赖后，重新构建并部署项目，确保依赖正确加载。

注意事项

• 版本兼容性：确保添加的jar包版本与项目中使用的其他库兼容。
• 依赖管理：使用Maven或Gradle等依赖管理工具可以自动处理依赖关系，避免手动管理jar包。

总结

通过添加缺失的Apache Commons Logging依赖，可以解决Tomcat运行时的 ClassNotFoundException。建议使用依赖管理工具来维护项目依赖，以减少此类错误的发生。

相关资源

• Apache Commons Logging官方文档