classnotfoundexception表示jvm运行时通过字符串名（如class.forname）加载类时，类加载器在classpath中未找到对应字节码；它非编译错误，仅说明该类文件确实缺失于运行时路径。

ClassNotFoundException 表示 JVM 在运行时尝试通过字符串名加载类（如 Class.forName() 或 ClassLoader.loadClass()）时，压根没在当前类加载器的路径中找到对应字节码。它不是编译错误，也不怪代码写错——只说明那个 类文件确实不在运行时 classpath 里。

先确认是不是真“找不到”，而不是“找错了”

别急着改依赖，先看异常栈里报的是哪个全限定名（比如 com.fasterxml.jackson.databind.ObjectMapper），然后做三件事：

• 用 IDE 的 Ctrl+Shift+N（IntelliJ）或 Ctrl+O（Eclipse） 搜索这个类名，看是否能定位到 class 文件 —— 搜不到，基本就是缺依赖；搜到了，可能是 scope、打包或类加载器问题
• 把异常里的类名复制出来，去 mvnrepository.com 搜，确认它属于哪个 artifact（比如 jackson-databind）
• 检查有没有拼写错误：大小写、包名变更（org.apache.commons.lang.StringUtils ≠ org.apache.commons.lang3.StringUtils）、内部类写法（Outer$Inner 不是 Outer.Inner）

查 Maven 实际拉了哪些依赖

pom.xml 写了不等于运行时就有。执行：

mvn dependency:tree -Dverbose | grep -A 5 -B 5 "目标类名"

重点关注：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

• 有没有输出？没输出 = 该 jar 根本没进依赖树
• 有没有 omitted for conflict 或 omitted for duplicate？说明被版本冲突自动剔除了
• 有没有 <exclusions></exclusions> 块悄悄移除了关键传递依赖（比如 Spring Boot starter 排除了 slf4j-api）
• scope 是不是 provided 或 test？这类依赖不会参与运行时 classpath，本地 mvn exec:java 或 java -jar 必炸

验证打包结果里到底有没有这个类

IDE 跑得通但 java -jar 报错？大概率是 fat jar 没打全。

• Spring Boot 项目：确保用 mvn spring-boot:repackage（不是 mvn install）生成可执行 jar
• 普通 Maven 项目：确认用了 maven-shade-plugin 或 spring-boot-maven-plugin；默认 mvn package 只打 thin jar
• 检查 jar 包内容：
  Linux/mac：jar -tf your-app.jar | grep ObjectMapper
  Windows：jar -tf your-app.jar \| findstr ObjectMapper

看 JVM 实际加载了什么

加启动参数临时诊断：

java -verbose:class -cp your-app.jar MainClass 2>&1 | grep "目标类名"

输出会显示：是否尝试加载、从哪个 jar 加载、是否成功。如果完全没出现这行，说明 JVM 根本没扫描到含该类的 jar —— 类路径配置或依赖缺失坐实了。

注意：-verbose:class 会影响性能，仅排查时启用。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南