ClassCastException 是运行时异常,当 JVM 尝试将对象强制转换为不兼容类型时抛出;典型场景包括非法强转、集合取值盲目转换、Spring getBean 未指定泛型及 JSON 反序列化用 Object.class 等。

ClassCastException 是什么,什么时候抛出
ClassCastException 是运行时异常(RuntimeException),发生在 JVM 尝试将一个对象强制转换为它实际类型不兼容的类或接口时。它不是编译期报错——编译器只看引用类型是否“看起来合法”,而 JVM 在执行 cast 指令时才会真正校验实际类型。
典型触发场景:用 (TargetType) obj 强转一个 obj,但其 getClass() 返回的类既不是 TargetType,也不是它的子类或实现类。
常见错误写法与对应现象
以下代码在运行时会立即抛出 ClassCastException:
Object x = new String("hello");
Integer i = (Integer) x; // java.lang.ClassCastException: java.lang.String cannot be cast to java.lang.Integer
其他高频踩坑点:
立即学习“Java免费学习笔记(深入)”;
- 从
Collection或数组中取出元素后盲目强转,例如List里混存了String和Integer,统一按(String)转 - 使用反射调用
Method.invoke()后,对返回值不做instanceof判断就强转 - Spring 中从
ApplicationContext.getBean("xxx")获取 bean 时未指定泛型,返回Object后直接强转成错误类型 - JSON 反序列化用
ObjectMapper.readValue(json, Object.class)得到LinkedHashMap,却当成自定义类强转
如何安全地避免 ClassCastException
核心原则:**不依赖“我觉得它应该是”这种直觉,而用运行时类型信息做判断或替代方案**。
- 改用
instanceof预检再强转:if (obj instanceof String) { String s = (String) obj; } - 优先使用泛型容器,如
List替代List,让编译器提前拦截类型不匹配 - 反序列化时明确指定目标类型,避免用
Object.class:User user = mapper.readValue(json, User.class);
- 必要时用
Class.cast()方法代替括号语法,它语义更清晰且可配合泛型变量使用:String s = String.class.cast(obj); // 抛出相同异常,但更易读
ClassCastException 和 NullPointerException 的混淆点
两者都常出现在类型操作链中,但根源不同:ClassCastException 要求对象非 null 且类型不匹配;而如果待强转对象本身就是 null,则不会抛 ClassCastException,因为 null 可以被赋给任意引用类型(包括强转目标)。
例如:
Object obj = null; String s = (String) obj; // 合法,s == null,不抛异常
所以看到 ClassCastException,基本可以断定:对象存在,只是类型不对。排查重点应放在数据来源和类型流转路径上,而不是空指针检查。










