Spring Data MongoDB动态查询分页排序及List转Page优化咨询

方案一：用MongoTemplate直接实现分页查询（最优，数据库层面处理分页排序） #

不用先查全量List再转Page，直接让MongoDB处理分页和排序逻辑，比内存操作高效得多。核心是动态构建查询条件，绑定Pageable参数让数据库返回排序后的分页数据，最后封装成Page对象。

代码示例：

@Repository
public class EmployeeRepositoryImpl implements EmployeeCustomRepository {

    private final MongoTemplate mongoTemplate;

    // 构造注入MongoTemplate
    public EmployeeRepositoryImpl(MongoTemplate mongoTemplate) {
        this.mongoTemplate = mongoTemplate;
    }

    @Override
    public Page<Employee> findEmployees(String branchId, String department, boolean activeOnly, Pageable pageable) {
        // 1. 构建动态查询条件
        Criteria criteria = Criteria.where("branchId").is(branchId)
                                    .and("department").is(department);
        if (activeOnly) {
            criteria.and("active").is(true);
        }

        // 2. 绑定分页与排序规则
        Query query = new Query(criteria).with(pageable);

        // 3. 查询分页数据
        List<Employee> content = mongoTemplate.find(query, Employee.class);

        // 4. 查询符合条件的总条数（跳过分页参数）
        long total = mongoTemplate.count(query.skip(0).limit(0), Employee.class);

        // 5. 封装成带排序信息的Page对象
        return new PageImpl<>(content, pageable, total);
    }
}

// 自定义Repository接口
public interface EmployeeCustomRepository {
    Page<Employee> findEmployees(String branchId, String department, boolean activeOnly, Pageable pageable);
}

// 主Repository继承基础接口与自定义接口
public interface EmployeeRepository extends MongoRepository<Employee, String>, EmployeeCustomRepository {
}

这里的query.with(pageable)会自动把Pageable中的排序规则、页码、每页条数转换成MongoDB的skip、limit和sort参数，数据库直接返回排序后的分页数据，无需内存二次处理。

方案二：用@Query结合SpEL实现动态条件 #

不想写自定义Repository实现的话，可以直接在@Query注解里用Spring表达式语言（SpEL）动态拼接条件，实现active条件的可选性，代码更简洁。

代码示例：

public interface EmployeeRepository extends MongoRepository<Employee, String> {

    @Query(value = "{ 'branchId': ?0, 'department': ?1, " +
            "#{#activeOnly ? '\"active\": true' : ''} }",
            countQuery = "{ 'branchId': ?0, 'department': ?1, " +
            "#{#activeOnly ? '\"active\": true' : ''} }")
    Page<Employee> findEmployees(String branchId, String department, boolean activeOnly, Pageable pageable);
}

当activeOnly为true时，SpEL会拼接"active": true到查询条件中；为false时拼接空字符串，不影响原有查询逻辑。注意要同步处理countQuery，保证Page的总条数统计准确。

方案三：用Querydsl实现动态查询（适合复杂场景） #

如果后续有更多动态条件需求（比如多字段可选过滤），Querydsl是更灵活的选择，提供类型安全的查询构建能力，直接支持返回Page对象。

步骤1：引入依赖（根据Spring Boot版本调整） #

<dependency>
    <groupId>com.querydsl</groupId>
    <artifactId>querydsl-mongodb</artifactId>
</dependency>
<dependency>
    <groupId>com.querydsl</groupId>
    <artifactId>querydsl-apt</artifactId>
    <scope>provided</scope>
</dependency>

步骤2：扩展Repository接口 #

public interface EmployeeRepository extends MongoRepository<Employee, String>, QuerydslPredicateExecutor<Employee> {
}

步骤3：构建动态查询并返回Page #

@Service
public class EmployeeService {

    private final EmployeeRepository employeeRepository;
    private final QEmployee qEmployee = QEmployee.employee;

    public Page<Employee> findEmployees(String branchId, String department, boolean activeOnly, Pageable pageable) {
        BooleanBuilder predicate = new BooleanBuilder();
        predicate.and(qEmployee.branchId.eq(branchId))
                .and(qEmployee.department.eq(department));
        if (activeOnly) {
            predicate.and(qEmployee.active.isTrue());
        }
        return employeeRepository.findAll(predicate, pageable);
    }
}

Querydsl的BooleanBuilder可以灵活拼接动态条件，findAll(predicate, pageable)直接返回带分页和排序的Page对象，无需手动处理List转Page的逻辑。

内容的提问来源于stack exchange，提问作者Borgy Manotoy