noclassdeffounderror是运行时类加载失败，非编译错误；需定位异常栈顶的“失踪类”，核查其所属依赖、版本兼容性、传递依赖完整性、打包排除规则及静态初始化异常。
这个错误不是编译失败，而是运行时类加载失败——说明代码能编译通过，但 JVM 找不到某个类的 .class 文件。关键要盯住异常栈顶那行报错的类名，它才是真正的“失踪者”，而不是你直接写的类。
看准报错类，反查它属于哪个依赖
比如堆栈第一行是：
java.lang.NoClassDefFoundError: org/apache/commons/lang3/StringUtils
这说明 JVM 想加载 StringUtils 时失败了。但它很可能不是你代码里显式写的，而是某个你引入的库（比如 Jackson 或 Spring Boot）内部用到的。
- 去 mvnrepository.com 搜索
StringUtils，确认它归属org.apache.commons:commons-lang3 - 检查项目是否声明了该依赖，版本是否合理（尤其注意 Spring Boot 父 POM 可能排除或降级了它）
- 如果用了 Maven Shade 或 Gradle Shadow 打包，确认没在
minimizeJar或exclude规则里误删了它
查依赖传递链有没有断掉
很多情况是“依赖的依赖”丢了。例如你加了 jackson-dataformat-xml，但它依赖 stax2-api，而构建配置（如 Gradle 的 implementation + transitive = false）或 Maven 的 <exclusions></exclusions> 把这条链掐断了。
- Maven：运行
mvn dependency:tree -Dincludes=stax2-api（把stax2-api替成实际缺失类所属的 groupId/artifactId） - Gradle：运行
./gradlew dependencies --include-used --configuration runtimeClasspath | grep stax - 如果目标依赖没出现在最终
runtimeClasspath里，就得手动补上，或改作用域（比如从compileOnly改为implementation）
验证运行时 classpath 真包含那个类
别只信 IDE 或 pom.xml —— 要实锤。JVM 启动时加参数：-verbose:class（打印所有被加载的类）
或 -XX:+TraceClassLoading（更详细）
然后看日志里有没有加载你关心的那个类。
- 也可以在代码里加一行：
System.out.println(ClassLoader.getSystemClassLoader().getResource("org/apache/commons/lang3/StringUtils.class"));，输出null就说明真没找到 - 如果是 Spring Boot jar 包，用
jar -tf your-app.jar | grep StringUtils直接查它是否被打进去了 - 普通 war 或目录部署，检查
WEB-INF/lib/或 classpath 指向的路径下是否存在对应 jar
留意静态初始化失败这个隐藏原因
有时报 NoClassDefFoundError，但根本原因是该类的静态块抛了异常（比如读配置失败、连不上 Redis），导致类加载中止。后续再访问这个类，JVM 就直接报 NoClassDefFoundError，而不会重试加载。
- 重点看异常堆栈里的
Caused by:部分，它往往藏着真正出问题的Exception（比如NullPointerException或NoClassDefFoundError嵌套） - 检查报错类的
static { ... }块，以及它依赖的其他静态资源或类 - 这类问题在本地跑得通、上线就崩，很典型——因为线上环境缺少某些静态初始化需要的配置或服务
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
