ClassCastException根源在于未启用泛型检查，导致编译器放行、JVM不拦，取值强转时崩溃；需定位原始类型映射与运行时强转交汇点，全链路泛型化并开启-Xlint:unchecked校验。
直接排查这类问题，核心是定位“原始类型映射”与“运行时强转”的交汇点。它不是泛型用错了，而是根本没启用泛型检查——编译器放行，JVM 不拦，但取值时一强转就崩。
确认是否为 Raw Type 引发的 ClassCastException
看异常堆栈里有没有这些典型特征：
- 异常发生在从集合或 DAO 返回结果后做 (String)、(User) 这类显式强转时
- 调用栈中出现
get(0)、getValue()、getResultList()等返回Object的方法 - 底层框架日志或源码里有
List list = new ArrayList()或Map map = new HashMap()这类无泛型声明 - IDE 或编译输出中有
unchecked warning（尤其配合-Xlint:unchecked时）
回溯映射层：检查实体与持久化配置的泛型一致性
旧框架（如早期 Hibernate、iBatis、自研 ORM）常通过 XML 或注解绑定字段，但若未约束泛型边界，实际返回的就是 Raw 类型：
- 检查 DAO 接口方法返回类型：是
List还是List<user></user>？若是前者，就是根源 - 查看 XML 映射文件（如
xxx.hbm.xml或xxx-mapper.xml）中<resultMap>是否只定义了class="User"，却没在 Java 方法签名中体现 - 若用注解（如
@Select("...")），确认返回值是否写成List而非List<Order>；MyBatis 3.4+ 支持泛型接口，但老版本或误配会退化为 Raw - NHibernate 中若使用
IList（非IList<T>）或object[]作为查询结果容器，也会丢失类型信息
验证运行时行为：用反射和 getClass() 辅助诊断
在报错位置前后加临时诊断代码，确认擦除是否已发生：
System.out.println(list.getClass() == new ArrayList<String>().getClass()); // true → 已擦除System.out.println(list.get(0).getClass()); // 可能是 String，也可能是 Integer，取决于谁塞进去- 对泛型字段做反射检查：
Field f = obj.getClass().getDeclaredField("items"); System.out.println(f.getGenericType());—— 若输出java.util.List（而非java.util.List<com.example.User>），说明泛型声明缺失
修复路径：从声明到调用全链路泛型化
不只改一行 <String>，要确保契约贯穿始终：
- DAO 接口方法签名必须带完整泛型：
List<Product> findAllByCategory(String cat) - XML 映射中启用
resultType="com.example.Product"或resultMap="productResultMap"，并确保<resultMap>的type属性指向具体类 - 避免中间层用
Object或Map接收结果；若必须通用，改用Map<String, Object>或List<?>并配合instanceof判断 - 开启编译检查：
-Xlint:unchecked -Werror，让 Raw Type 使用直接编译失败，不留给测试阶段 - 对老代码批量修复，可用 IntelliJ 的
Replace Structurally或 SonarQube 规则java:S1905（Raw type used）自动识别
