Tomcat环境下无法找到Apache DigestUtils类问题求助

我之前在Servlet项目里也碰到过完全一样的情况——本地跑起来没问题，一部署到Tomcat就报错，偶尔换个项目还会复发。折腾了好一阵，总结出几个核心原因和彻底解决的方法：

1. 依赖版本冲突（最常见） #

Tomcat本身的lib目录可能包含了旧版本的commons-codec，或者你的项目依赖里间接引入了不同版本的该类库，导致类加载时出现版本不兼容的问题。

解决步骤：

• 先排查项目的依赖树，找出所有commons-codec的引用：
  • Maven项目执行命令：mvn dependency:tree | grep commons-codec
  • Gradle项目执行命令：gradle dependencies | grep commons-codec
• 确保所有依赖的commons-codec版本统一（建议用最新稳定版，比如1.15），排除掉其他依赖带进来的旧版本。比如在Maven里可以这样排除：

  <dependency>
      <!-- 这里是你的某个依赖，比如spring-core -->
      <groupId>org.springframework</groupId>
      <artifactId>spring-core</artifactId>
      <version>xxx</version>
      <exclusions>
          <exclusion>
              <groupId>commons-codec</groupId>
              <artifactId>commons-codec</artifactId>
          </exclusion>
      </exclusions>
  </dependency>
  

• 确保项目的commons-codec依赖是compile范围（默认就是），这样打包时会把它放进WEB-INF/lib目录，Web应用的类加载器会优先加载这个目录下的类，避免和Tomcat自带的版本冲突。

2. 类加载器顺序问题 #

本地运行时用的是项目自身的类加载器，而Tomcat中系统类加载器可能先加载了旧版本的DigestUtils，导致应用无法找到正确的类。

解决方法：

• 检查Tomcat的lib目录，如果里面有commons-codec.jar，直接删除它（除非有其他必须依赖这个版本的应用，那建议把你的项目的commons-codec打包进WEB-INF/lib，并确保版本兼容）。
• 清理Tomcat的work目录（路径一般是TOMCAT_HOME/work），这里存放了Tomcat编译后的类文件，有时候旧的类缓存会导致加载异常，清理后重启Tomcat。

3. 热部署或缓存残留导致的偶发问题 #

偶尔出现的报错大概率是热部署时类加载混乱，或者项目打包时残留了旧的类文件。

解决步骤：

• 关闭Tomcat的热部署功能（在conf/server.xml里找到Context标签，把reloadable="true"改成false），或者每次部署前手动重启Tomcat，避免热加载带来的类冲突。
• 打包War包前，先清理项目的编译目录：
  • Maven执行：mvn clean package
  • Gradle执行：gradle clean war
    确保没有旧的类文件或jar包残留。

4. 权限问题（概率较低但需排查） #

如果Tomcat运行的用户没有权限读取WEB-INF/lib里的commons-codec.jar，也会导致类加载失败。

解决方法：

• 检查War包解压后的WEB-INF/lib目录权限，确保Tomcat运行用户有读取权限：
  • Linux系统执行：chmod -R 755 /path/to/your/webapp/WEB-INF/lib
  • Windows系统右键目录，在“安全”选项卡中给Tomcat运行用户添加读取权限。

总结一下，优先排查依赖冲突和类加载顺序问题，清理缓存和旧文件，基本就能彻底解决这个问题。

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