ClassNotFoundException表示JVM在类路径中找不到指定类，主因是缺失提供该类的JAR包；需依“定位缺失类→查所属库→验JAR是否在classpath”三步诊断，并区分其与NoClassDefFoundError。
当 Java 运行时抛出 ClassNotFoundException，通常意味着 JVM 在类路径（classpath）中找不到你代码里引用的某个类。这绝大多数情况是**缺失了提供该类的 Jar 包**，而不是代码写错了类名。诊断的关键在于：**快速定位“哪个类没找到” → “这个类本该在哪个 Jar 里” → “这个 Jar 是否真的在 classpath 中”**。
看异常堆栈，精准锁定缺失的类名
不要只看异常类型，重点读第一行异常消息和堆栈最顶端的 at 行：
- `java.lang.ClassNotFoundException: org.apache.http.client.methods.CloseableHttpResponse` —— 这就是缺失的类全限定名
- 再看上一行 `at com.example.MyService.sendRequest(MyService.java:22)` —— 知道是哪行代码触发的，方便回溯依赖来源
拿到类名后，立刻搜索它属于哪个开源库（比如 Google、Maven Repository 或直接查 Apache 官网），例如上面这个类属于 httpclient（Apache HttpClient），对应 Maven 坐标是 org.apache.httpcomponents:httpclient:4.5.14。
检查运行时实际 classpath，确认 Jar 是否真被加载
编译通过 ≠ 运行时有 Jar。常见误区是只在 IDE 里加了依赖，但打包或部署时漏了。分场景验证：
立即学习“Java免费学习笔记（深入）”；
- IDE 运行（如 IntelliJ）：右键项目 → Open Module Settings → Modules → Dependencies，确认对应 Jar（或 Maven 依赖）状态为“Compile”或“Runtime”，且没有黄色警告图标
-
Jar 包启动：用
java -cp "lib/*" MyApp启动时，先ls lib/看目录下是否有httpclient-4.5.14.jar；注意通配符*在 Windows 和 Linux 下行为一致，但某些旧 JDK 版本不支持，可改用完整路径列表 -
Spring Boot 打包应用：解压生成的
xxx.jar，进入BOOT-INF/lib/目录，用jar -tf xxx.jar | grep httpclient检查是否包含目标 Jar
用 JVM 参数或代码辅助验证类加载来源
如果仍不确定，启用 JVM 类加载日志或在代码中主动探测：
- 启动时加参数：
-verbose:class，JVM 会打印每个被加载的类及其来源 Jar（如[Loaded org.apache.http.client.methods.CloseableHttpResponse from file:/app/lib/httpclient-4.5.14.jar]）。没看到目标类，就说明它根本没被加载 - 在报错前加一段诊断代码：
System.out.println(ClassLoader.getSystemClassLoader().getResource("org/apache/http/client/methods/CloseableHttpResponse.class"));。如果输出null，证明 classpath 中确实没有含该类的 Jar
区分 ClassNotFoundException 和 NoClassDefFoundError
别混淆两者：
-
ClassNotFoundException：发生在Class.forName()、ClassLoader.loadClass()或反射调用时，明确表示“这个类字面量根本找不到” -
NoClassDefFoundError：发生在类已成功加载过，但在初始化（执行static块）时因依赖的其他类缺失而失败。它更隐蔽，但根源往往也是缺 Jar —— 只是缺的是“被依赖的类”的 Jar，不是当前报错类的 Jar
遇到后者，要顺着它的 cause（如果有）或错误信息里的“… could not be initialized”往回找，最终大概率还是回到 ClassNotFoundException 那一层。
