ClassCastException在向下转型且目标类型与对象实际类型不兼容时抛出，如Animal引用错误转为Cat、泛型擦除后原始类型强转、反射返回值误转等；应通过instanceof检查、使用带类型参数的泛型、优先多态来避免。
ClassCastException 是 Java 运行时异常，发生在强制类型转换（cast）失败时——即试图将一个对象引用转换为它实际类型不兼容的类型。
什么情况下会抛出 ClassCastException
只有在向下转型（downcast）且目标类型与对象真实类型不匹配时才会触发。向上转型（upcast）总是安全的，不会抛异常；而 instanceof 检查能提前规避风险。
- 父类引用指向子类对象，但错误地转成另一个无关子类：
Animal a = new Dog();
Cat c = (Cat) a; // 抛出 ClassCastException - 使用泛型擦除后绕过编译检查的原始类型操作：
List list = new ArrayList();
list.add("hello");
Integer i = (Integer) list.get(0); // 运行时报错 - 反射中调用
Method.invoke()后错误强转返回值，尤其当方法返回Object却假设为特定类型时。
如何避免 ClassCastException
核心原则是：不确定时先检查，再转换；能用泛型就别用裸类型；优先依赖多态而非强制转型。
Java Maven Common
下载
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
- 转型前用
instanceof判断（注意：JDK 14+ 支持模式匹配语法，更简洁）：
if (obj instanceof String s) { System.out.println(s.length()); } - 集合操作务必使用带类型参数的泛型，避免原始类型（raw type）：
List<String> list = new ArrayList<>(); // 而非 List - 设计上尽量用多态替代类型判断和转型，例如把行为提取到接口或抽象方法中。
常见误区与调试提示
这个异常本身不难理解，但容易因代码结构复杂而定位困难。
立即学习“Java免费学习笔记（深入）”；
- 堆栈信息只显示抛异常的位置，需逆向追踪对象来源——重点检查谁创建了该引用、中间是否经过泛型擦除或反射处理。
-
getClass().getName()和toString()可快速确认运行时真实类型，比猜更有用。 - Lombok 的
@Data或 Jackson 反序列化时若字段类型不匹配，也可能间接引发此类异常，需核对 JSON 结构与 Java 类定义。
不复杂但容易忽略。关键在养成“转型必检查”和“泛型写全”的习惯。
