本地Maven项目调试遇java.lang.ClassNotFoundException，服务器运行正常求助

一、解决本地异常的排查步骤 #

1. 检查Eclipse的Tomcat部署配置 #

• 打开项目的Properties -> Deployment Assembly，确认所有依赖jar包（尤其是包含缺失类的依赖）都已添加到部署列表中，确保这些依赖会同步到本地Tomcat的webapps目录下。
• 若有依赖未被包含，点击Add -> Java Build Path Entries，选择对应的依赖添加。

2. 清理构建与运行缓存 #

• 执行Maven命令彻底清理并重新构建：mvn clean install，保证target目录的编译产物是最新的。
• 在Eclipse中执行Project -> Clean，选择当前项目清除编译缓存，避免旧类文件干扰。
• 删除本地Tomcat的work/Catalina/localhost/[你的项目名]目录下的所有文件，清除Tomcat缓存的类加载数据。

3. 验证调试配置的类路径 #

• 打开Run/Debug Configurations，找到对应的Tomcat服务器配置，切换到Classpath标签页：
  • 确认项目的编译输出目录（如target/classes）已在类路径中。
  • 检查所有依赖jar是否都被正确包含，无遗漏或重复。

4. 对齐JDK版本 #

• 检查本地Eclipse项目的JDK编译版本（Properties -> Java Build Path -> Libraries）、本地Tomcat启动使用的JDK版本（Tomcat配置中的JRE选项），尽量与服务器Tomcat的JDK版本保持一致，避免字节码兼容性问题。

二、本地与服务器Tomcat的可能差异 #

1. 基础环境差异 #

• JDK版本/位数：服务器与本地使用的JDK主版本（如JDK8 vs JDK11）、32/64位可能不同，会影响类加载和字节码解析。
• Tomcat版本：主版本（如8.5 vs 9.0）或小版本差异，不同版本的类加载机制、默认配置存在区别，比如类加载优先级规则不同。

2. 配置文件差异 #

• conf/web.xml：服务器可能配置了全局监听器、过滤器或类加载相关参数，本地默认配置无这些内容。
• conf/catalina.properties：类加载顺序、禁止加载的jar包列表等配置可能不同，比如服务器设置了tomcat.util.scan.DefaultJarScanner.jarsToSkip排除冲突jar，本地未配置。
• conf/context.xml：服务器可能配置了自定义数据源、资源链接或类加载器，本地缺少对应配置导致类加载路径不一致。

3. 环境变量与启动参数 #

• 服务器的CATALINA_OPTS或JAVA_OPTS可能添加了额外的类路径参数（如-cp）、类加载相关调试参数，本地未配置这些参数。

4. 依赖与目录差异 #

• 服务器Tomcat的lib目录可能包含本地没有的必要jar包，或者本地lib目录存在与项目依赖冲突的jar，导致类加载优先级问题。
• 部署方式：服务器直接部署war包由Tomcat自动解压，而本地Eclipse采用热部署或自定义部署路径，可能存在文件同步不完整的情况。

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