排查Java泛型错误关键在编译期，需重视unchecked警告、规避擦除导致的ClassCastException、禁用运行时类型参数操作、正确使用通配符协变。
排查 Java 泛型编程错误，关键不在运行时抓异常，而是在编译期看清类型契约是否被破坏。多数问题源于对类型擦除机制的误判或约束缺失，而非逻辑写错。
看编译报错信息，别跳过“unchecked”警告
Java 编译器遇到泛型不安全操作（如原始类型赋值、强制转型、反射调用）时，不会直接报错，而是发出 unchecked 警告。例如：
-
Map map = new HashMap();→ 编译通过但警告：使用了原始类型 -
List list = (List) obj;→ 警告：未经检查的类型转换 - 调用
get()后直接强转：(String) map.get("key")→ 隐含 ClassCastException 风险
这些警告不是可忽略的提示，而是编译器在说：“我无法保证这段泛型代码是类型安全的”。启用 -Xlint:unchecked 参数让警告变错误，能提前拦截 80% 的泛型隐患。
查运行时 ClassCastException，反推泛型擦除漏洞
当出现 ClassCastException，尤其发生在集合取值、方法返回或反射场景中，大概率是泛型擦除导致的“假安全”：
立即学习“Java免费学习笔记（深入）”；
-
List<String> list = new ArrayList<>(); list.add(123); String s = list.get(0);→ 编译期不拦（因擦除后是List），运行时报错 - 用
ObjectInputStream反序列化泛型对象，取值时强转失败 - 泛型方法返回
T，但实际返回的是擦除后的Object，调用方误信类型
对策：避免在泛型容器中混入非声明类型；对 get() 结果做 instanceof 检查；必要时用 getOrDefault(key, defaultValue) 或 Optional 包装返回值。
验构造与反射场景，确认类型参数是否“真存在”
泛型类型参数在运行时不存在，因此以下写法全部非法：
-
new T()→ 编译错误 -
T.class→ 编译错误 -
Class<T> clazz = (Class<T>) getClass().getGenericSuperclass();→ 只能拿到Class，拿不到具体泛型参数
若需运行时类型信息，必须显式传入 Class<T> 实参：
private final Class<T> type;
public Box(Class<T> type) { this.type = type; }
}
调用时写 new Box<String>(String.class)，而非依赖编译器“猜”。
盯住多态与继承边界，防止协变误用
Java 泛型默认**不可协变**。常见误解：
-
List<String> strs = new ArrayList<>(); List<Object> objs = strs;→ 编译失败（≠数组） - 把
ArrayList<Integer>当作List<Number>传参 → 不兼容
如需向上兼容，用通配符：
void process(List<? extends Number> numbers) { ... } // 可接收 List<Integer>、List<Double>但注意：? extends 只读，? super 只写 —— 这是 PECS（Producer Extends, Consumer Super）原则的核心。
