ClassNotFoundException 的核心原因是 JVM 运行时找不到引用的类，需确认类存在且在类路径中可见；检查类名拼写与包结构、依赖范围与打包方式、类路径配置及 JDK 模块变动。
ClassNotFoundException 的核心原因是 JVM 在运行时找不到你代码中引用的类。它不是编译错误，而是在 Class.forName()、ClassLoader.loadClass() 或反序列化等动态加载场景下才触发。解决的关键在于确认“类是否存在”和“JVM 是否能看见它”这两件事。
检查类名与包结构是否完全匹配
Java 对大小写和拼写极其敏感。比如 com.example.PageInterceptor 和 com.example.pageinterceptor 是两个不同类；少一个字母（如 PageIntercepto）或大小写错位（如 pagehelper 写成 PageHelper）都会失败。
- 打开对应类的源文件或 .class 文件，核对 package 声明和文件路径是否一致（例如
package com.oykq.pagehelper;对应/src/main/java/com/oykq/pagehelper/PageInterceptor.java） - 使用
Class.forName("全限定类名")时，必须带完整包名，不能省略 - IDE 中按 Ctrl+Click（IntelliJ）或 F3（Eclipse）跳转该类，若跳转失败，说明编译期已不可见，问题更早
确认依赖是否真正进入运行时类路径
编译通过 ≠ 运行时可用。尤其在使用 Maven/Gradle 时，compile 范围的依赖不会自动打包进 fat jar，而 provided 范围的依赖在运行时根本不存在。
- Maven 项目执行
mvn dependency:tree -Dincludes=group-id:artifact-id查看目标依赖是否被正确解析且无版本冲突 - 检查
pom.xml中依赖的<scope>：Web 应用中javax.servlet-api设为provided是合理的，但spring-context必须是默认 scope（即compile） - 打包后解压 JAR/WAR，进入
BOOT-INF/lib/（Spring Boot）或WEB-INF/lib/（传统 Web），确认对应 JAR 文件存在且内部包含目标 class（可用jar -tf xxx.jar | grep PageInterceptor）
验证类路径配置是否生效
类路径（classpath）是 JVM 查找类的唯一依据。IDE、构建工具、命令行三者类路径常不一致，容易误判。
立即学习“Java免费学习笔记（深入）”；
- 运行时显式指定：
java -cp "lib/*:." com.example.Main（注意分隔符：Windows 用;，Linux/macOS 用:） - 检查启动脚本中是否覆盖了
-cp或-classpath参数，或设置了错误的JAVA_CLASS_PATH环境变量 - 在代码中打印当前类路径：
System.out.println(System.getProperty("java.class.path"));，确认关键 JAR 或目录确实在列表中 - Tomcat 等容器中，确保第三方 JAR 放在
WEB-INF/lib/（应用级）或$CATALINA_HOME/lib/（全局级），而非随意丢进项目根目录
留意 JDK 版本带来的模块变动
从 JDK 9 开始引入模块系统，部分 Java EE 类（如 javax.xml.bind.*、javax.activation.*）被移出默认模块，需手动添加或开启访问。
- 若报错涉及
javax.xml.bind.JAXBException等，说明 JAXB 已不在java.base模块中 - Maven 添加依赖：
javax.xml.bind:jaxb-api、com.sun.xml.bind:jaxb-impl等 - 或启动时加参数：
--add-modules java.xml.bind（JDK 9–10）或--add-modules ALL-SYSTEM（JDK 11+，慎用） - Spring Boot 2.3+ 默认排除
spring-boot-starter-web-services，若需 JAXB，需显式引入
