ClassCastException 是 Java 运行时因非法强制类型转换抛出的异常,根本原因是对象实际类型与目标类型无继承或实现关系;常见于集合取值盲转、反射调用后未校验、JSON 反序列化类型丢失等场景;可通过 instanceof 预检、泛型约束、明确反序列化类型等方式避免。

ClassCastException 是 Java 中运行时抛出的异常,发生在强制类型转换失败时——也就是你试图把一个对象转成它实际类型不兼容的另一种类型。
根本原因:对象实际类型与目标类型无继承/实现关系
Java 的向下转型(downcast)必须满足“该对象在运行时确实是目标类型的实例”,否则 JVM 拒绝转换。编译器只检查引用类型是否可能兼容(比如父类转子类),但真正判断靠运行时对象的实际类。
- 例如:Object obj = new String("hello"); → Integer i = (Integer) obj; 会抛出 ClassCastException,因为 obj 实际是 String,和 Integer 完全无关
- 再如:List list = new ArrayList(); → ArrayList arr = (ArrayList) list; 是安全的;但如果 list 实际是 new LinkedList(),同样会失败
常见触发场景
- 从集合中取出元素后盲目强转,比如 List 里混存了多种类型,取出来直接 (String) obj 而不校验
- 使用反射获取对象后未确认类型就转型,如 Object result = method.invoke(...); (MyService) result;
- 序列化/反序列化后类型信息丢失,比如用 JSON 工具将 Map 反序列化为 Object,再强行转成自定义类
- 泛型擦除导致编译期无提示,运行时才暴露问题(如原始类型 List 被当作 List
使用)
如何避免 ClassCastException
- 转型前用 instanceof 判断: if (obj instanceof String) { String s = (String) obj; }
- 优先使用泛型,让编译器在源头约束类型,减少运行时转型需求
- 集合操作尽量用明确泛型,避免裸类型(raw type)或 Object 通配
- 反序列化时指定准确的目标类型,不要依赖默认 Object 解析
- 必要时封装安全转型工具方法,内部集成 instanceof + 强转逻辑
不是所有转型都会报这个错
向上转型(upcast)永远安全,比如 String s = "a"; Object o = s; 不需要强转也不会异常;自动装箱/拆箱引发的是 NullPointerException 或 NumberFormatException,不属于 ClassCastException。










