Java List转IPage转换异常如何处理？

Question

在使用MyBatis-Plus进行分页操作时，开发者常遇到“Java List转IPage转换异常”的问题。该异常通常发生在试图将普通List直接转换为IPage对象时，由于类型不匹配或泛型丢失导致ClassCastException或IllegalStateException。常见于自定义分页查询后手动封装分页结果时。解决方法包括：使用MyBatis-Plus提供的Page构造器正确初始化IPage对象，并通过setRecords方法设置数据；或使用BeanUtils等工具进行深拷贝，确保类型一致。此外，注意泛型信息的保留，避免类型擦除引发问题。

Answer 1

一、问题背景与现象

在使用 MyBatis-Plus 进行分页查询时，很多开发者会遇到“Java List 转 IPage 转换异常”的问题。这类异常通常表现为 ClassCastException 或 IllegalStateException，尤其在手动封装分页结果时尤为常见。

问题的核心在于开发者尝试将一个普通的 List<T> 对象直接转换为 IPage<T> 类型，而忽略了类型不匹配或泛型信息丢失的问题。

二、异常原因分析

• 类型不匹配：直接使用类型转换操作符（如 (IPage<T>) list）会导致运行时类型错误。
• 泛型信息丢失：Java 的泛型在运行时被擦除（Type Erasure），导致 IPage 无法正确识别内部记录的类型。
• 对象结构不一致：IPage 是一个接口，其实现类（如 Page）包含分页信息（如当前页、页大小、总记录数等），而普通 List 并不具备这些属性。

三、解决方案详解

方案一：使用 Page 构造器正确封装

推荐使用 MyBatis-Plus 提供的 Page 构造器来创建 IPage 对象，并通过 setRecords() 方法设置数据。

// 假设你已查询到一个 List<User> userList
IPage<User> userPage = new Page<>(pageNum, pageSize);
userPage.setRecords(userList);
userPage.setTotal(totalCount); // 设置总记录数
    

方案二：使用 Bean 工具进行深拷贝

在某些场景下，可能需要将一个包含分页信息的对象转换为 IPage。此时可以使用 BeanUtils.copyProperties() 或 Dozer、MapStruct 等工具进行深拷贝。

Page<User> page = new Page<>(pageNum, pageSize);
BeanUtils.copyProperties(page, sourcePage); // sourcePage 是一个包含分页信息的对象
    

方案三：自定义分页封装逻辑

在复杂的业务场景中，可以自定义一个分页封装逻辑，确保泛型信息保留，并正确设置分页参数。

public <T> IPage<T> wrapPage(List<T> list, long pageNum, long pageSize, long total) {
    IPage<T> page = new Page<>(pageNum, pageSize);
    page.setRecords(list);
    page.setTotal(total);
    return page;
}
    

四、常见误区与避坑指南

误区	问题描述	建议做法
强制类型转换	试图将 List 强转为 IPage	使用 Page 构造器或深拷贝
忽略泛型信息	泛型丢失导致 ClassCastException	使用泛型方法封装分页逻辑
未设置总记录数	分页数据不完整	务必调用 setTotal()

五、流程图说明

graph TD
            A[开始] --> B{是否使用 MyBatis-Plus 分页}
            B -- 是 --> C[使用 Page 构造器]
            C --> D[调用 setRecords 设置数据]
            D --> E[调用 setTotal 设置总数]
            B -- 否 --> F[使用 Bean 工具深拷贝]
            F --> G[确保泛型一致]
            G --> H[返回 IPage 对象]