ClassNotFoundException核心原因是JVM运行时找不到目标类字节码，需从类加载路径、依赖实际状态和运行环境三层排查：先验类名拼写与包路径是否正确，再查运行时classpath是否包含该类，最后确认依赖是否真正打进包中且未被排除或作用域限制。
ClassNotFoundException 的核心原因是 JVM 在运行时按需加载类的过程中，找不到目标类的字节码文件。排查不能只看报错类名，得顺着类加载路径、依赖实际状态和运行环境三层去验证。
先确认是不是真缺这个类
很多情况下，异常不是因为 JAR 缺失，而是类名写错了——比如大小写不符（StringUtils 写成 stringutils）、包路径过时（org.apache.commons.lang.StringUtils 应该是 org.apache.commons.lang3.StringUtils）、反射字符串漏了包前缀或多了空格。
- 用 IDE 的「Go to Class」（Ctrl+Shift+N）搜全限定名，看能否定位到 class 文件
- 把异常栈里冒号后的完整类名复制出来，去 mvnrepository.com 搜索，反向查它属于哪个 artifact
- 如果是
Class.forName("xxx")触发的，检查字符串是否来自配置、数据库或用户输入，是否可能被截断或转义
查运行时真正生效的 classpath
编译能过不代表运行时有这个类。关键要看 JVM 启动时实际加载了哪些路径和 JAR。
- 启动时加参数
-verbose:class 2>&1 | grep "YourClassName"，直接看到 JVM 是否尝试加载过它、从哪加载的 - 程序已运行？用
jcmd <pid> VM.system_properties | grep java.class.path查当前生效的 classpath - 手动检查：在 classpath 指定的目录下执行
find . -name "*.jar" | xargs -I{} sh -c 'echo {}; jar -tf {} | grep "com/example/SomeClass.class"'
验证依赖是否真的打进包里了
Maven 默认 mvn package 生成的是 thin jar，不含依赖；Spring Boot 项目若没执行 mvn spring-boot:repackage，生成的 jar 也无法直接运行。
立即学习“Java免费学习笔记（深入）”；
- 执行
jar -tf your-app.jar | grep "SomeClass.class"，确认类文件是否真在 fat jar 中 - 查依赖树：
mvn dependency:tree -Dverbose | grep -A 5 -B 5 "com.fasterxml.jackson"（替换为目标类全限定名），看是否被omitted for conflict或exclusions移除了 - 特别注意
<scope>provided</scope>和<scope>test</scope>：前者只在容器中提供（如 Tomcat），本地java -jar必须手动补；后者不会传递给 main 模块
盯住类加载器链和双亲委派行为
不是所有类加载器都能访问你放的 JAR。比如 Web 应用中，WEB-INF/lib 下的类由 WebAppClassLoader 加载，而 lib/ext 下的由 PlatformClassLoader 加载。
- 在代码里打印加载器层级：
ClassLoader cl = Thread.currentThread().getContextClassLoader(); while (cl != null) { System.out.println(cl); cl = cl.getParent(); } - Tomcat 环境重点检查
WEB-INF/classes和WEB-INF/lib目录是否存在对应 JAR 或 class - OSGi、Java Agent、模块化（JPMS）等特殊环境，要确认模块声明（
requires）和导出（exports）是否完备
