ClassCastException 是 RuntimeException 子类,发生在强制向下转型失败时;核心场景是 (TargetType) 强转非兼容类型对象,如 Object obj = new String("a"); (Integer) obj;应通过 instanceof 预检、泛型约束、反射类型校验等预防,而非捕获。

什么是 ClassCastException?
Java 中没有 TypeCastException,实际抛出的是 ClassCastException —— 它是运行时异常(RuntimeException 子类),发生在强制类型转换失败时。编译器无法在编译期完全检查所有类型转换逻辑,所以这类错误只会在运行中暴露。
哪些操作会触发 ClassCastException?
核心场景只有一个:用 (TargetType) 语法对引用进行向下转型(downcast),且实际对象不是目标类型的实例或其子类。
- 将父类引用强制转为不兼容的子类,例如:
Object obj = new String("a"); Integer i = (Integer) obj; - 泛型擦除后未做类型检查就强转,如从
ArrayList取元素直接转成错误类型 - 反射调用
Method.invoke()后对返回值盲目强转 - 使用
instanceof判断不完整(比如漏掉null检查)导致误转
如何安全地避免 ClassCastException?
关键不是“捕获它”,而是“提前预防”。因为它是编程逻辑错误,不是可恢复的业务异常。
- 转型前必加
instanceof判断(注意:JDK 14+ 支持模式匹配,可写成if (obj instanceof String s)直接绑定变量) - 集合操作时优先使用泛型,避免裸类型(raw type);若必须用
Object,取出后先检查再转 - 反射场景下,用
Method.getReturnType()或返回值的getClass()辅助判断 - 不要 catch
ClassCastException并吞掉——这通常掩盖了设计缺陷
Object obj = getValue();
if (obj instanceof List) {
List list = (List) obj; // 安全
}
ClassCastException 和泛型、类型擦除的关系
泛型在编译后被擦除,JVM 运行时看不到泛型参数。所以 List 和 List 在运行时都是 List。如果往一个本该存 String 的 List 里塞了 Integer,取出来时强转就会崩。
立即学习“Java免费学习笔记(深入)”;
- 编译器对泛型的检查只到方法入口/出口,中间过程靠开发者自律
-
@SuppressWarnings("unchecked")是危险信号,每处都应有明确注释说明为何安全 - 工具如 SpotBugs 或 IDE 的 inspection 能帮发现潜在不安全强转
最易忽略的一点:数组协变性也会引发类似问题,比如 Object[] arr = new String[1]; arr[0] = new Integer(1); 会在运行时报 ArrayStoreException,而非 ClassCastException,但根源一样——类型契约被破坏。










