classnotfoundexception表示jvm运行时找不到指定类，主因是类路径缺失、类名或包路径错误（含大小写、内部类符号$）、依赖未打包、类加载器隔离或版本/作用域冲突，解决关键在于精准定位缺失环节而非盲目添加依赖。
ClassNotFoundException 说明 JVM 在运行时找不到指定的类，核心原因是类路径（Classpath）缺失、类名写错、类加载器隔离或依赖未正确打包。解决的关键是定位“为什么找不到”，而不是盲目加依赖。
检查类名和包路径是否完全匹配
Java 区分大小写，且要求全限定类名（包括包名）与实际字节码文件结构严格一致。常见错误包括：
- 代码中写的是 com.example.UserService，但实际类文件在 com/example/user/UserService.class（包名是 com.example.user）
- 误把内部类写成 OuterClass.InnerClass，而运行时需用 OuterClass$InnerClass
- 拼写错误，如 Arraylist（少了个 L）或 HttpServlet 写成 Httpservlet
确认类是否在运行时 classpath 中
编译通过不代表运行时能加载。需检查启动命令或 IDE 运行配置中的 classpath：
- 命令行启动时，用 -cp 或 -classpath 显式指定所有 JAR 和 classes 目录，例如：
java -cp "lib/*:classes/" com.example.Main - Maven 项目打包成 jar 后，默认不包含依赖；要用 maven-assembly-plugin 或 maven-shade-plugin 构建 fat jar
- IDE（如 IntelliJ）中检查 Run Configuration → Classpath 是否包含模块输出目录和依赖库
排查类加载器委托机制导致的隔离问题
在 Web 容器（Tomcat）、OSGi 或自定义 ClassLoader 环境中，不同类加载器相互隔离，即使类存在也可能无法跨加载器访问：
- Web 应用中，WEB-INF/lib 下的类由 WebAppClassLoader 加载，不能直接访问 $CATALINA_HOME/lib 中由 CommonClassLoader 加载的类（除非显式委托）
- 使用 Thread.currentThread().getContextClassLoader() 加载资源时，确保它能访问目标类；必要时改用 MyClass.class.getClassLoader()
- 避免在静态块或类初始化阶段，用错误的类加载器去加载另一个模块的类
验证依赖是否真正可用且版本兼容
尤其在 Maven/Gradle 项目中，ClassNotFoundException 常是传递依赖被排除、版本冲突或 scope 错误所致：
- 执行 mvn dependency:tree -Dverbose 查看依赖树，确认目标类所属的 artifact 是否被 excluded 或因 version conflict 被裁剪
- 检查依赖的 scope：如 test 或 provided 的依赖不会参与运行时打包
- 某些库（如 slf4j-api）只提供接口，必须搭配具体实现（slf4j-simple、logback-classic），缺一不可
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
