instanceof用于安全判断对象是否为某类或其子类实例,是向下转型前必须的轻量校验;它对null返回false、不抛异常,右侧仅支持具体类型而非泛型;Java14+支持模式匹配语法。

instanceof 用来判断对象是否是某类或其子类的实例
直接用 instanceof 检查运行时类型,是向下转型前最轻量、最安全的前置校验手段。它只在对象非 null 且实际类型匹配(含继承关系)时返回 true;对 null 永远返回 false,不会抛异常。
常见错误是跳过校验直接强转,比如:(Dog) animal,一旦 animal 实际是 Cat 或 null,立刻触发 ClassCastException。
- 必须在转型前用
instanceof判断,不能靠注释或“我觉得应该是”来代替 -
instanceof右侧只能是类、接口、或已加载的引用类型;不能是泛型类型擦除后的原始类型(如List可以,List<String>编译不通过) - Java 14+ 支持模式匹配语法:
if (obj instanceof Dog d),此时d已完成安全转型并可直接使用,但需注意该语法要求目标类型是 final 类或密封类(sealed class)
向下转型前不校验的典型报错场景
最常见的崩溃就是 ClassCastException,例如:
Object obj = "hello"; Integer i = (Integer) obj; // 运行时报 java.lang.ClassCastException: java.lang.String cannot be cast to java.lang.Integer
这类错误往往在测试覆盖不到的分支里暴露,尤其出现在集合取值、反射调用、或框架回调传参后直接转型时。
- 从
Map<String, Object>取值后未校验就转成Boolean或LocalDateTime,极易出错 - Spring 的
BeanFactory.getBean()返回Object,直接强转而忽略实际 bean 类型可能已改变(如被代理、被包装) - Android 中
findViewById()返回View,有人写(TextView) findViewById(R.id.tv)却忘了布局里可能是EditText
instanceof 和 getClass() == 的关键区别
instanceof 检查的是“是否为该类型或其子类型”,而 obj.getClass() == SomeClass.class 是严格等价匹配,不接受子类。
- 需要支持多态扩展时(如判断是否为
Animal及其任意子类),必须用instanceof Animal - 若业务逻辑只接受精确类型(如反序列化后必须是
UserV1,不能是UserV2子类),才考虑getClass(),但更推荐用策略枚举或版本字段替代硬类型判断 -
getClass()对null会 NPE,而instanceof不会——这是它更安全的底层原因之一
泛型集合中取元素时的转型陷阱
泛型在运行时被擦除,List<String> 在 JVM 看来只是 List,所以 list.get(0) instanceof String 是必要且有效的校验方式。
不要依赖 IDE 提示或编译期类型推断,尤其当集合来自外部输入、JSON 反序列化(如 Jackson 默认把数字转成 Integer,字符串才是 String)或遗留代码混用原始类型时。
- 反序列化 JSON 数组到
List<Object>后,每个元素都得单独用instanceof判断再转:可能是String、Integer、LinkedHashMap(对应 JSON 对象) - 避免写
(String) list.get(0)这种裸转型;应写成if (list.get(0) instanceof String s)(Java 14+)或先判后转 - 如果频繁出现同类校验逻辑,建议封装为工具方法,如
castIfInstanceOf(obj, String.class),内部统一处理null和类型检查
BigDecimal,但上游某次修复悄悄改成了 Double,或者日志里刚打出的 obj.getClass().getName() 是 com.example.MyType$$EnhancerBySpringCGLIB$$...。这时候 instanceof 不是啰嗦,是底线。

















