新手求助：如何结合Pageable与JPQL实现分页查询？

你已经拿到了Pageable对象，但还没正确把它的参数应用到QueryDSL的JPQL查询里，而且当前实现丢失了分页关键的元数据（总条数、总页数等）。我来帮你一步步修正：

问题分析 #

你的现有代码存在几个关键问题：

• 硬编码了limit(20)，没有使用Pageable中的pageSize参数
• 手动指定了排序规则，没有复用Pageable传入的Sort配置
• 返回的是List，无法向上层传递分页元数据（比如总记录数、当前页、总页数）

解决方案 #

我们需要修改Repository层，让它返回Spring Data的Page对象（包含分页元数据），并正确应用Pageable的所有参数：

1. 修改Repository方法返回类型 #

把返回值从List<T>改成Page<T>，这样能携带完整的分页信息。

2. 应用Pageable的分页参数 #

替换硬编码的limit，改用pageRequest.getPageSize()和pageRequest.getOffset()。

3. 将Pageable的Sort转换为QueryDSL的OrderSpecifier #

QueryDSL可以直接将Spring Data的Sort转换成对应的排序规则，不需要手动写OrderSpecifier。

修改后的完整代码 #

Repository层代码

@Repository 
public class CompanyRepositoryImpl{ 
    @PersistenceContext 
    private EntityManager entityManager; 

    public Page<Company> getCompany(BooleanExpression finalExpression, Pageable pageRequest) { 
        QCompany comp = QCompany.company; 
        QCompanyAddress qCompanyAddress = QCompanyAddress.companyAddress; 

        // 初始化JPQL查询
        JPQLQuery<QCompany> jpqlQuery = new JPAQuery(entityManager); 

        // 构建查询逻辑（保留你的关联和过滤条件）
        JPQLQuery<QCompany> query = jpqlQuery.from(comp)
            .leftJoin(qCompanyAddress) 
                .on(comp.id.eq(qCompanyAddress.company.id) 
                    .and(qCompanyAddress.statusActiveSwitch.eq(SwitchEnum.Y)) 
                    .and(qCompanyAddress.addressType.addressTypeCode.eq("1"))) 
            .where(finalExpression); 

        // 应用Pageable的排序规则
        if (pageRequest.getSort().isSorted()) {
            List<OrderSpecifier<?>> orderSpecifiers = pageRequest.getSort()
                .stream()
                .map(order -> {
                    // 支持关联对象的排序（比如按地址字段排序）
                    PathBuilder<?> pathBuilder;
                    if (order.getProperty().startsWith("companyAddress.")) {
                        String prop = order.getProperty().replace("companyAddress.", "");
                        pathBuilder = new PathBuilder<>(QCompanyAddress.class, qCompanyAddress.getMetadata().getName());
                        return new OrderSpecifier(
                            order.isAscending() ? Order.ASC : Order.DESC,
                            pathBuilder.get(prop)
                        );
                    } else {
                        pathBuilder = new PathBuilder<>(QCompany.class, comp.getMetadata().getName());
                        return new OrderSpecifier(
                            order.isAscending() ? Order.ASC : Order.DESC,
                            pathBuilder.get(order.getProperty())
                        );
                    }
                })
                .collect(Collectors.toList());
            query.orderBy(orderSpecifiers);
        }

        // 应用分页参数：offset和limit
        query.offset(pageRequest.getOffset())
             .limit(pageRequest.getPageSize());

        // 获取查询结果和总记录数
        QueryResults<QCompany> fetchResults = query.fetchResults(); 
        List<QCompany> results = fetchResults.getResults(); 
        long total = fetchResults.getTotal(); 

        // 构建Page对象返回（包含分页元数据）
        return new PageImpl<>(results, pageRequest, total); 
    } 
}

Service层代码

对应修改返回类型，让上层能直接拿到分页信息：

public Page<Company> getCompanies(BooleanExpression predicate, Pageable pageRequest){ 
    return companyRepositoryImpl.getCompany(predicate, pageRequest); 
}

关键改动说明 #

• 返回Page对象：PageImpl是Spring Data提供的Page接口实现类，包含了当前页数据、总记录数、每页大小、当前页号等所有分页元数据，上层可以用这些信息构建分页UI。
• 动态应用排序：我特意处理了关联对象的排序场景（比如按companyAddress.addressLine1排序），你可以在调用方通过Sort.by("companyAddress.addressLine1").desc()灵活指定排序规则，不需要在Repository里硬编码。
• 使用Pageable的分页参数：offset是当前页的起始位置（Spring Data已经帮你计算好：pageNumber * pageSize），limit是每页条数，完全复用Pageable的配置，实现动态分页。

内容的提问来源于stack exchange，提问作者Dheeraj kumar