如何将对象列表转为分页数据？当前分页失效问题排查

问题根源 #

你先查询了全部Product数据，再把完整的Dto列表传入PageImpl构造器——但PageImpl并不会自动对传入的列表做分页切割，它只是简单包装整个数据集，所以返回的自然是全部数据，而非指定分页的结果。

正确实现方式 #

推荐方案：先分页查实体，再转Dto（性能最优）

直接利用Spring Data JPA的分页能力，避免全量查询，这是最合理的做法：

1. 仓库层直接使用自带的分页查询方法（无需额外定义）
2. 拿到分页后的实体Page对象，用map()批量转Dto，自动保留分页元数据

示例代码：

// 仓库层（Spring Data JPA默认提供分页查询能力）
public interface ProductRepository extends JpaRepository<Product, Long> {
}

// 业务层实现
public Page<ProductDto> getProducts(Pageable pageable) {
    // 先分页查询实体
    Page<Product> productPage = productRepository.findAll(pageable);
    // 批量转换为Dto，自动继承分页参数（页码、页大小、总条数等）
    return productPage.map(this::convertToDto);
}

// 实体转Dto工具方法
private ProductDto convertToDto(Product product) {
    ProductDto dto = new ProductDto();
    // 赋值逻辑，例如：
    dto.setId(product.getId());
    dto.setName(product.getName());
    return dto;
}

特殊场景：必须先处理全量数据（不推荐，大数据量下性能差）

如果业务上必须先获取全量数据再处理，需要手动对Dto列表做分页截取，同时传入正确的分页参数和总条数：

public Page<ProductDto> getProducts(Pageable pageable) {
    // 查询全量实体并转为Dto列表
    List<Product> allProducts = productRepository.findAll();
    List<ProductDto> allDtoList = allProducts.stream()
                                             .map(this::convertToDto)
                                             .collect(Collectors.toList());

    // 计算分页截取的起止索引
    int pageSize = pageable.getPageSize();
    int currentPage = pageable.getPageNumber();
    int startIndex = currentPage * pageSize;
    int endIndex = Math.min(startIndex + pageSize, allDtoList.size());

    // 截取当前页的数据
    List<ProductDto> pageContent = allDtoList.subList(startIndex, endIndex);

    // 构造正确的分页对象：传入当前页数据、分页参数、总数据条数
    return new PageImpl<>(pageContent, pageable, allDtoList.size());
}

注意事项 #

• 优先用第一种方案，全量查询会在数据量大时导致严重的性能问题
• PageImpl的第三个参数必须是总数据条数，而非当前页的条数，否则前端无法正确计算总页数、总条数等分页信息

内容的提问来源于stack exchange，提问作者Dadaboy Masharipov