安全向下转型须先用 instanceof 预检再转换（Java 8+），或使用模式匹配 instanceof（JDK 14+正式支持），严禁裸强转；避免 getClass() 比较、泛型擦除强转等陷阱，频繁转型提示设计缺陷，应优先考虑多态或策略模式重构。

安全向下转型的核心是“先确认、再转换”，不能依赖业务逻辑的“应该没问题”。直接强转（(SubType) obj）在运行时一旦类型不匹配，立刻抛 ClassCastException，而这种错误往往在特定数据路径下才暴露，难以覆盖测试。

用 instanceof 预检 + 显式转换（兼容 Java 8+）

这是最通用、最稳妥的做法。instanceof 成本极低，且天然处理 null（返回 false），避免空指针。

• 写法清晰：先判断，再转换，语义明确
• 必须分开两步：不能省略判断直接强转
• 示例：
  if (obj instanceof Dog) {
    Dog dog = (Dog) obj;
    dog.bark();
  }

用模式匹配 instanceof（推荐 JDK 14+）

Java 14 引入、JDK 21 成为正式特性，把类型检查和变量绑定合二为一，更简洁、更安全。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

• 变量作用域严格受限于该分支，编译器保障非 null 且类型正确
• 不会因中间修改 obj 值导致后续转型失败（老写法有此风险）
• 示例：
  if (obj instanceof Dog dog) {
    dog.bark(); // dog 已是 Dog 类型，无需再转
  }

避免常见陷阱

向下转型不是设计常态，而是类型信息丢失后的补救手段。频繁出现，往往说明抽象不足。

• 不用 getClass() == Xxx.class 判断：它不接受子类实例（如 Poodle extends Dog 不会被 Dog.class 匹配）
• 不依赖泛型擦除后的原始类型强转：比如 (List) list 编译虽过，运行取值才崩
• 不在循环或回调中裸强转：如处理 List 时，每个元素都应独立判型

考虑设计替代方案

如果大量代码都在做 if-else instanceof 分支，建议重构：

• 提取统一接口，让各子类自行实现关键行为（多态）
• 用策略模式或访问者模式解耦类型判断逻辑
• 用 Optional 封装可能为空或类型不确定的结果，把校验内聚在链式调用中

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南