Java泛型擦除本身不抛ClassCastException，但导致运行时类型不匹配强转时出错；关键在提前拦截、精准识别、安全兜底：声明带泛型、禁用裸类型、读取前校验、反序列化显式传TypeReference/TypeToken、调试关注真实类型。
Java 泛型擦除本身不会抛出 ClassCastException，但会为它埋下隐患——真正出问题的，是运行时类型不匹配却仍强行转换的那一刻。处理的关键不是“修复擦除”，而是提前拦截、精准识别、安全兜底。
从源头堵住不安全的原始类型使用
泛型擦除后，List 和 List<String> 在运行时都是 List，但编译器能靠泛型约束帮你挡住大部分风险：
- 声明集合时务必带具体泛型：用
List<User> users = new ArrayList<>();，而不是List users = new ArrayList(); - 避免无注释的
@SuppressWarnings("unchecked")；若必须用，需明确写清原因，比如“上游已保证元素全为 BigDecimal” - 禁用裸类型（raw type）传参：方法签名别写
void process(List data)，应写<T> void process(List<T> data)或void process(List<? extends Number> data)
读取集合元素前做类型校验
当不得不处理未知来源的集合（如反序列化结果、RPC 响应），不能默认“它就是我要的类型”：
JavaStoryDevelop
下载
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
- 对单个对象，先判空再用
instanceof：if (obj != null && obj instanceof User) { User u = (User) obj; ... } - 对集合元素，避免直接强转循环体：
for (Object o : list) { String s = (String) o; }—— 改为先检查每个o是否为String，或改用流式过滤：list.stream().filter(String.class::isInstance).map(String.class::cast).forEach(...) - 注意：
instanceof List<String>编译不通过，只能写instanceof List；泛型信息得靠反射或业务协议辅助判断（如约定响应中"type": "user_list"）
反序列化场景必须显式传递泛型结构
JSON 转对象时最常触发 ClassCastException，根本原因是 Jackson/Gson 默认只认类名，不知道字段里的泛型到底是什么：
立即学习“Java免费学习笔记（深入）”；
- Jackson 用
TypeReference：objectMapper.readValue(json, new TypeReference<Response<List<Order>>>() {}) - Gson 用
TypeToken：gson.fromJson(json, new TypeToken<Response<List<Order>>>() {}.getType()) - 更稳妥的做法是定义具体子类：
class OrderResponse extends Response<List<Order>> {}，然后传OrderResponse.class - 加一层防御：捕获
JsonProcessingException，记录原始 JSON 和失败字段，返回统一错误响应，避免异常穿透到业务层
调试时快速定位擦除引发的类型错位
异常堆栈只告诉你“转不了”，但不说“它本来是什么”。调试要聚焦运行时真实类型：
- 在 IDE 中断点停住，展开变量看
obj.getClass()和obj.toString()，尤其注意details这类泛型字段是否变成LinkedHashMap或ArrayList - 日志里打印关键对象的类型：
log.debug("details type: {}", details.getClass().getName()); - 对泛型字段，尝试用反射获取实际参数类型（仅限字段/方法签名中保留的情况）：
((ParameterizedType) field.getGenericType()).getActualTypeArguments()[0]
