ClassNotFoundException 是受检异常，表示JVM在类路径中未找到指定类，需显式处理；它由Class.forName()等动态加载触发，而非new实例化，常见于类名错误、类路径缺失或类加载器不可见。
ClassNotFoundException 是什么，为什么它不是 RuntimeException
ClassNotFoundException 是 java.lang.Exception 的子类，属于受检异常（checked exception）。这意味着编译器强制要求你处理它——要么用 try-catch 捕获，要么在方法签名中声明 throws ClassNotFoundException。它和 NoClassDefFoundError 常被混淆，但后者是 Error，发生在类已加载过、但运行时因静态初始化失败或依赖缺失而无法再次链接时；而 ClassNotFoundException 明确表示：JVM 在类路径（classpath）里根本没找到你要 Class.forName()、ClassLoader.loadClass() 或反射加载的那个类。
常见触发场景与对应修复方式
它几乎只出现在显式类加载行为中，而不是普通 new 实例化时（那是编译期检查）。以下是最典型的几类原因：
- 调用
Class.forName("com.example.MyService")，但MyService.class没打包进 jar，或 jar 未加入 classpath - 使用
Thread.currentThread().getContextClassLoader().loadClass(...)，但当前线程的上下文类加载器（如 Tomcat 中的 WebAppClassLoader）看不到该类（例如放在lib/下却试图加载 WEB-INF/classes 里的类） - Spring 配置里写错
class属性值，比如com.example.dao.DaoImpl - Android 开发中通过反射调用新 API（如
Activity.getDisplay()），但在低版本系统上运行，该类根本不存在
修复核心就一条：确认目标类的完整限定名（FQN）拼写正确，并确保它在当前类加载器的可见范围内。
如何定位具体缺哪个类、从哪加载的
光看异常栈顶的 ClassNotFoundException: xxx 不够。你需要知道：
立即学习“Java免费学习笔记（深入）”；
- 谁在触发加载？查栈中最靠近顶部的
Class.forName、loadClass或框架代码行 - 用的是哪个类加载器？加一行日志：
System.out.println("CL: " + Thread.currentThread().getContextClassLoader()); - 该类加载器的 classpath 路径有哪些？对
URLClassLoader可打印((URLClassLoader) cl).getURLs()；对 Spring Boot 的LaunchedURLClassLoader，需用getClass().getProtectionDomain().getCodeSource().getLocation()查 jar 包位置
如果是在 IDE 中运行出错，检查模块依赖是否真正“exported”或“provided”，Maven 项目要确认 scope 不是 test 或 provided 却又在主流程中用了该类。
避免硬编码类名 + 安全替代方案
直接写死 Class.forName("xxx") 是高危操作。更健壮的做法包括：
- 改用编译期已知类型的静态引用，比如
MyService.class，这样 IDE 和编译器能提前报错 - 若必须动态加载，优先用服务加载机制：
ServiceLoader.load(MyPluginInterface.class)
，依赖META-INF/services/com.example.MyPluginInterface文件声明实现类 - 对插件或模块化场景，明确指定类加载器：
MyPluginClassLoader.loadClass("com.example.PluginImpl")，而非依赖上下文类加载器 - Android 上用
Build.VERSION.SDK_INT做版本守卫，避免反射调用不存在的类
最常被忽略的一点：ClassNotFoundException 本身不包含类加载器信息，也不告诉你“为什么找不到”。它只是个结果信号，真正的线索永远藏在调用链、类加载器层级和构建配置里。
