Java类型转换必须安全可预期,核心是运行前用instanceof校验而非裸cast;数组用isArray()判断;包装类拆箱前必判空;泛型集合需二次过滤;应封装safeCast工具并统一入口校验。

Java 类型转换不是“能转就行”,而是要确保转得安全、可预期、可维护。核心原则就一条:不信任运行时类型,所有转换前必须验证。
用 instanceof 做前置校验,别裸 cast
直接强制转换((String) obj)是 ClassCastException 的主要源头。必须先确认对象真实类型:
- 对单个对象:用 if (obj instanceof String) 判断后再 cast
- 对集合元素:避免 (String) list.get(0),改用 stream 过滤 + cast:
list.stream().filter(String.class::isInstance).map(String.class::cast).collect(...) - 注意数组特殊性:new int[0] instanceof Object[] 是 false,但 new String[0] 是 true —— 判断数组类型建议用 obj.getClass().isArray() + obj.getClass().getComponentType()
包装类拆箱前必判空,防 NPE 于未然
Integer、Long 等自动拆箱不是发生在赋值时,而是在参与 ==、算术运算、方法调用等瞬间触发 intValue() 或 longValue() —— 此时 null 就崩。
- 错:if (num != null && num > 0) → > 仍会触发拆箱
- 对:先显式判空再取值:if (num != null) { int v = num.intValue(); ... }
- 更简洁:用 Optional.ofNullable(num).orElse(0) 或 Objects.requireNonNullElse(num, 0)
- 从 Map/JSON 取值:优先用 map.getOrDefault("key", 0),而不是 get 后立刻运算
泛型集合不保类型安全,运行时需二次过滤
泛型擦除导致 List<String> 在运行时就是 List,JVM 允许往里面塞任何对象。不能假设 get 出来的一定是 String。
立即学习“Java免费学习笔记(深入)”;
- 反模式:String s = (String) rawList.get(0);
- 推荐:Object item = rawList.get(0); if (item instanceof String) { ... }
- 批量处理:用 rawList.stream().filter(String.class::isInstance).map(String.class::cast)
- 设计层面:对外返回集合时,永远返回 Collections.unmodifiableList(...) 或空集合,不返回 null
封装转换逻辑,统一处理边界和异常
把类型校验 + 转换 + 异常兜底打包成可复用方法,避免散落各处的 if/cast/try-catch。
- 写一个泛型安全转换工具:<T> T safeCast(Object obj, Class<T> type),内部用 isInstance 校验,失败抛带上下文的 IllegalStateException
- 对 JSON 或 RPC 返回值,定义 DTO 时字段加默认值(如 private Integer status = 0;),比处处判空更可靠
- 关键入参入口(如 Controller 方法、RPC 接口实现)统一加 Objects.requireNonNull 或 JSR-380 注解(@NotNull/@NotBlank)


















