Spring Rest调用TradePhoneService抛出ClassCastException问题排查

常见原因 #

• 泛型类型擦除导致的隐藏强转问题：Java泛型仅在编译期生效，运行时会被擦除为原生类型。如果你的listBeansToVos方法是直接将DAO返回的List整体强转为List<TpbPrvtRecPhoneExtVO>，而非逐个转换元素，编译期不会报错，运行时访问List内元素时就会抛出类型转换异常。
• DAO层返回元素类型不匹配：检查DAO层listarRamaisDiponiveis方法的返回值映射配置，比如MyBatis的resultType、JPA的实体映射是否写错，导致查询返回的元素不是预期的DO类，转换为VO时失败。
• 类加载器冲突：如果TpbPrvtRecPhoneExtVO被不同的类加载器加载，哪怕全类名完全一致，JVM也会判定为不同类，强转时抛出异常。常见触发场景包括启用了devtools、jrebel等热部署工具，或者同一类被多个依赖jar重复打包。
• 类型转换方法实现错误：listBeansToVos如果没有完成DO到VO的属性拷贝逻辑，直接返回原始List，会导致泛型声明和实际元素类型不符。

排查步骤 #

1. 先查看完整异常栈信息，确认异常提示的两个待转换类的具体信息：如果是XXXDO cannot be cast to TpbPrvtRecPhoneExtVO，说明是元素类型转换问题；如果是两个完全相同全类名的TpbPrvtRecPhoneExtVO互转，说明是类加载器冲突问题。
2. 检查listBeansToVos方法实现，正确写法需要遍历DAO返回的List，逐个将DO对象的属性拷贝到新的VO对象中，存入新的List返回，禁止直接整体强转List：

// 错误示例
public List<TpbPrvtRecPhoneExtVO> listBeansToVos(List list) {
    return (List<TpbPrvtRecPhoneExtVO>) list;
}
// 正确示例
public List<TpbPrvtRecPhoneExtVO> listBeansToVos(List<TradePhoneDO> daoList) {
    List<TpbPrvtRecPhoneExtVO> voList = new ArrayList<>();
    for(TradePhoneDO item : daoList) {
        TpbPrvtRecPhoneExtVO vo = new TpbPrvtRecPhoneExtVO();
        // 拷贝属性，可使用BeanUtils.copyProperties等工具
        BeanUtils.copyProperties(item, vo);
        voList.add(vo);
    }
    return voList;
}

3. 检查DAO层方法的泛型声明和查询映射配置，确认返回的List元素为预期的DO类型。
4. 排查类加载冲突：先禁用热部署工具重启项目验证，如问题依旧，检查项目依赖中是否存在重复的TpbPrvtRecPhoneExtVO类，可分别在Rest、Service、DAO层打印该类的类加载器实例，确认是否为同一个。

内容的提问来源于stack exchange，提问作者Markinhus Santiago