编写CSV数据提取Servlet时遭遇java.lang.NoClassDefFoundError异常求助

首先，先把你遇到的异常信息贴出来方便对照：

类型 异常报告
消息 Servlet执行抛出异常
描述 服务器遇到意外情况，无法完成请求。
异常 javax.servlet.ServletException: Servlet执行抛出异常
org.apache.tomcat.websocket.server.WsFilter.doFilter(WsFilter.java:53)
根本原因 java.lang.NoClassDefFoundError: org/apache/commons/lang3/ObjectUtils

嘿，这个错误我之前做CSV解析的Servlet时也踩过坑！java.lang.NoClassDefFoundError的核心原因就是：你的代码编译时能找到org.apache.commons.lang3.ObjectUtils这个类，但运行时服务器找不到它的字节码文件。说白了就是依赖没配对或者没放对地方。

给你几个一步步解决的方案：

1. 确认Apache Commons Lang3依赖是否正确引入 #

如果你用Maven/Gradle构建项目： #

• Maven的话，在pom.xml里添加这个依赖（版本可以选最新稳定版，比如3.14.0）：

<dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-lang3</artifactId>
    <version>3.14.0</version>
    <scope>compile</scope>
</dependency>

• 然后执行mvn clean install，确保依赖被下载并打包到你的WAR包中。

如果你是手动管理jar包： #

• 下载Commons Lang3的jar包（注意是commons-lang3开头的，不是旧的commons-lang），然后把它放到你项目的WEB-INF/lib目录下——这个目录是Web项目运行时类加载器会扫描的地方，千万不要放到Tomcat全局的lib目录（除非你所有项目都要用，不然容易引发类加载冲突）。

2. 检查项目打包配置 #

如果你用IDE（比如IDEA/Eclipse），要确认打包WAR的时候，WEB-INF/lib目录下确实包含了commons-lang3-x.x.x.jar：

• IDEA：打开Project Structure -> Artifacts，检查你的WAR artifact里是否包含了这个jar，没有的话手动添加。
• Eclipse：右键项目 -> Export -> WAR File，勾选"Export generated class files and resources"，确保依赖jar被包含进去。

3. 清理重建项目 #

有时候IDE的缓存或者编译残留会导致依赖没被正确加载，试试：

• 清理项目：Maven执行mvn clean，IDE里点"Clean Project"。
• 重新编译打包：Maven执行mvn package，IDE里点"Rebuild Project"。
• 重启Tomcat服务器，确保旧的缓存被清空。

按照这几步来，基本就能解决这个问题啦！

内容的提问来源于stack exchange，提问作者Someone