Java运行时四大高频报错：ClassNotFoundException（类未加载）、NoClassDefFoundError（类初始化失败）、NullPointerException（空对象调用）、ClassCastException（非法类型转换），需依异常类型、触发时机、类生命周期精准排查。
Java 类与对象相关的报错，多数集中在运行时阶段，根源往往不是语法写错，而是类加载失败、对象状态异常或类型使用不当。排查关键不在于“猜哪行错了”，而在于看清异常类型、定位触发时机、回溯类生命周期。下面分四类高频问题，讲清楚怎么看、怎么查、怎么改。
ClassNotFoundException：类根本没被加载进来
这个异常说明 JVM 在运行时按名字找类（比如 Class.forName("com.example.Service")），但翻遍所有 classpath 和模块路径都找不到对应的 .class 字节码。
- 先确认是不是打包遗漏：用 jar -tf your-app.jar | grep Service 检查目标类是否真在 JAR 包里；Maven 项目要检查 dependency:tree 是否有传递依赖被排除
- 检查类加载器隔离：Spring Boot 的 Fat Jar 使用 LaunchedURLClassLoader，若手动 new ClassLoader 加载，可能和应用类加载器不在同一层级，导致双亲委派失效
- 注意大小写和包路径：Linux 下 com/example/Service.class 和 com/example/service.class 是两个不同文件，Windows 不敏感但部署到 Linux 就会报错
- JDK 9+ 模块系统下，如果类在 unnamed module，但调用方在 named module，且未声明 requires，也会触发该异常
NoClassDefFoundError：类曾加载过，但初始化失败了
它和 ClassNotFoundException 容易混淆，但本质不同：前者是“压根没找到”，后者是“找到了，但静态代码块或静态字段初始化时报了错（比如触发了另一个 ClassNotFoundException 或 ExceptionInInitializerError），导致 JVM 把这个类标记为不可用”。后续再引用该类，就抛 NoClassDefFoundError。
将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
- 重点看异常堆栈的“Caused by”部分——它上面那层才是真正的根因，比如可能是某个静态常量依赖了一个缺失的第三方类
- 检查类的 static { ... } 块、static final 字段赋值语句，尤其是涉及配置读取、资源加载、第三方工具初始化的地方
- 如果是微服务场景，注意跨服务的 DTO 类版本不一致：提供方升级了字段，消费方未同步更新 JAR，反序列化时静态类型检查失败，也可能引发此类错误
NullPointerException：对象是 null，却当它存在用
这是最常见也最容易被忽视的问题。报错位置通常不是空指针产生的地方，而是第一次调用它的方法或访问其字段时。
立即学习“Java免费学习笔记（深入）”；
- 不要只看报错行，往上翻堆栈，找到最靠近业务逻辑的那几行，检查入参、返回值、集合 get()、map.get()、数据库查询结果是否可能为 null
- 对明确不允许为空的参数，用 Objects.requireNonNull(obj, "xxx 不得为 null") 主动拦截，比等运行时报错更早暴露问题
- 集合操作别直接用 list.get(0)，先判空；字符串别直接调 length()，先用 StringUtils.isNotBlank() 或 Objects.nonNull()
- IDE 中开启空值分析（如 IntelliJ 的 “Enable nullability annotations”），配合 @Nullable / @NotNull 注解，让编译期就预警
ClassCastException：类型转换不兼容
发生在强制转型时，实际对象类型和目标类型无继承或实现关系，比如把 HashMap 强转成 ArrayList，或泛型擦除后误转。
- 转型前务必加 if (obj instanceof TargetType) 判断，尤其在处理 Object 类型参数、反射返回值、JSON 反序列化结果时
- 避免裸用原始类型集合：如 List list = new ArrayList()，往里塞 String 和 Integer，取出来强转就极易出错；应始终使用带泛型的声明 List
- JSON 场景特别小心：Jackson 默认把 JSON 数组反序列化为 List
，不是你写的 List ，直接转型必崩；要用 TypeReference 或明确指定泛型类型 - 父类引用指向子类实例时转型是安全的（向上转），但反过来（向下转）必须确保真实类型匹配，不能仅靠命名推测
