根本原因是类路径未包含目标类或类名拼写错误（含大小写、包名不全、带.class后缀等），而非类本身不存在。
Class.forName 加载类时为什么抛出 ClassNotFoundException
根本原因不是类不存在，而是类路径（classpath）没包含目标类所在位置，或者类名写错——注意必须是完整包名，比如 com.example.service.UserService，不能写成 UserService.class 或 UserService。
常见错误现象：ClassNotFoundException: com.example.service.UserService，但明明文件在 src/main/java/com/example/service/UserService.java 下。
- 确认编译后
UserService.class确实出现在target/classes/com/example/service/（Maven 项目）或对应输出目录中 - 检查运行时 classpath 是否包含该输出目录（IDE 运行配置里看 “Use classpath of module” 是否勾选，或
java -cp参数是否覆盖了它） - 类名字符串不能带
.class后缀，也不能用斜杠（/）代替点（.）
Class.forName("xxx") 和 ClassLoader.loadClass("xxx") 的区别在哪
Class.forName 默认会触发类的**静态初始化块执行**（即运行 static {}），而 ClassLoader.loadClass 不会。这是关键行为差异，直接影响类状态和副作用。
使用场景：如果你需要确保 static 块里的注册逻辑、配置加载、单例初始化等已发生，就用 Class.forName；如果只是获取 Class 对象做反射调用（比如后续 newInstance 或 getMethod），且想避免副作用，用 Thread.currentThread().getContextClassLoader().loadClass("xxx") 更安全。
-
Class.forName("com.example.Config")→ 触发static{} -
ClassLoader.getSystemClassLoader().loadClass("com.example.Config")→ 不触发static{} - 二者都要求类在 classpath 中，否则都抛
ClassNotFoundException
动态加载后怎么安全地创建实例（避免 NoClassDefFoundError）
成功拿到 Class 对象后，直接调用 clazz.newInstance() 已被废弃（Java 9+ 警告），且会因无参构造器不可访问或异常而失败。更可靠的方式是用 getDeclaredConstructor().newInstance()，并捕获具体异常。
容易踩的坑：类有 private 无参构造器，或构造器抛异常，或依赖的其他类在运行时缺失（此时报 NoClassDefFoundError，不是 ClassNotFoundException）。
- 先检查构造器可访问性：
clazz.getDeclaredConstructor().setAccessible(true) - 用 try-catch 包住
newInstance()，捕获InvocationTargetException（构造器内抛的异常）、InstantiationException（抽象类/接口）、IllegalAccessException（构造器不可访问） - 如果类依赖 Spring Bean 或其他容器管理对象，仅靠反射无法自动注入，需手动 set 或改用容器 API（如
applicationContext.getBean(clazz)）
Spring 环境下 Class.forName 失效的常见原因
在 Spring Boot 应用中，Class.forName("com.example.service.UserService") 可能失败，不是因为类不存在，而是当前线程上下文类加载器（Thread.currentThread().getContextClassLoader()）指向的是 Spring Boot 的 LaunchedURLClassLoader，而它可能没把某些模块 jar 加入搜索路径。
解决方案不是硬编码换类加载器，而是统一用上下文类加载器加载：
ClassLoader cl = Thread.currentThread().getContextClassLoader();
Class> clazz = cl.loadClass("com.example.service.UserService");
或者更稳妥地委托给 Spring 的资源工具：
Class clazz = ClassUtils.resolveClassName("com.example.service.UserService",
this.getClass().getClassLoader());
- 避免在 static 块里用
Class.forName加载业务类，因为此时上下文类加载器可能还没初始化好 - 如果类在 fat-jar 的
BOOT-INF/classes/下，标准Class.forName仍可用；但如果在BOOT-INF/lib/xxx.jar里，必须确保该 jar 被LaunchedURLClassLoader加载过
类加载看似一行代码，实际牵扯 classpath、类加载器委派、静态初始化时机、模块可见性多个层面。最常忽略的是：你以为的“类存在”，其实只存在于编译期，运行时它根本不在当前类加载器的视野里。
