java类加载失败主因是类路径未正确指定，需用-cp显式声明当前目录和依赖jar，确保包结构、大小写、类名格式（如com.example.service）与文件路径严格一致，并验证.class文件存在且字节码版本兼容。
Java 类加载失败，类路径错误是最常见原因。核心在于 JVM 只在明确指定的路径里找类，而不是“自动发现”。只要把类文件和依赖的位置告诉它，并确保格式、结构、大小写都对得上，问题基本就解了。
显式用 -cp 指定当前目录和依赖
别依赖系统 CLASSPATH 环境变量，它经常为空或配置错。命令行运行时，直接用 -cp（或 -classpath）覆盖：
- Linux/macOS：java -cp ".:lib/*" com.example.Main
- Windows：java -cp ".;lib/*" com.example.Main
- 如果 class 文件在
classes/目录，JAR 在lib/，就写成：java -cp "classes:lib/*" com.example.Main
确认包结构与类名完全一致
类加载器按包名逐级查找文件夹。哪怕一个字母大小写不对，或者用了斜杠代替点号，都会失败：
- 源码声明
package com.example;→ 编译后必须是com/example/Service.class - 运行时必须写全限定名：java -cp . com.example.Service（不能写
Service或com/example/Service） - 内部类要写成
OuterClass$InnerClass，不是OuterClass.InnerClass
检查依赖 JAR 是否真被包含
编译通过不等于运行能用。很多 ClassNotFoundException 其实是缺第三方 JAR：
- Maven 打出的普通 jar 默认不含依赖，要用
maven-shade-plugin打 fat jar，再运行 java -jar app.jar - 手动加依赖时，通配符
lib/*只匹配 lib 下一级的 JAR，不进子目录 - 用 jar -tf your-app.jar | grep SomeClass 确认目标类是否真的被打包进去了
验证 .class 文件是否真实存在且未损坏
有时候文件看着在，其实没编译成功、被误删，或字节码版本不兼容：
- 进对应目录，用 ls -l com/example/Main.class（Linux/macOS）或 dir com\example\Main.class（Windows）确认文件存在
- 用 file com/example/Main.class 查看字节码版本，确保没高于当前 JDK 版本
- 重新执行 javac -d . src/com/example/Main.java，保证输出路径和包结构严格匹配
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
