本文介绍如何在 Spring Boot 中利用 Pageable 接口统一处理分页与多字段排序（如 city、gender），无需手动解析参数，由框架自动绑定并注入控制器方法。
本文介绍如何在 spring boot 中利用 `pageable` 接口统一处理分页与多字段排序（如 city、gender），无需手动解析参数，由框架自动绑定并注入控制器方法。
在构建 RESTful 用户查询接口时，常需同时支持分页、条件搜索与多字段排序。Spring Data 提供的 org.springframework.data.domain.Pageable 是实现该需求的最佳实践——它天然整合了分页（page、size）与排序（sort）能力，且支持链式多字段排序及升降序控制。
✅ 正确用法示例
1. 控制器层（Controller）
直接将 Pageable 作为方法参数，Spring MVC 会自动从请求参数解析并构造其实例：
@GetMapping("/users")
public ResponseEntity<Page<UserDTO>> getUsers(
@ModelAttribute SearchUserDTO search,
Pageable pageable) {
Page<UserDTO> result = userService.searchAndSort(search, pageable);
return ResponseEntity.ok(result);
}⚠️ 注意：
@ModelAttribute用于绑定自定义搜索条件（如city、gender），而Pageable独立处理分页与排序，二者职责分离、互不干扰。
2. 请求 URL 示例
通过标准查询参数传递分页与排序逻辑：
GET /api/users?page=0&size=12&sort=city,asc&sort=gender,desc
✅ 支持多个 sort 参数，每个形如 field,direction（方向可选 asc/desc，默认 asc）；
✅ 字段名必须与实体类属性名严格一致（支持嵌套属性如 address.city）；
✅ 若未指定方向，自动按升序处理。
3. 服务层使用排序信息
在 Service 中，可通过 pageable.getSort() 获取排序规则，并结合 JPA Repository 的 findAll(Specification, Pageable) 或原生 Page<t> findAll(Pageable)</t> 方法执行查询：
public Page<UserDTO> searchAndSort(SearchUserDTO search, Pageable pageable) {
Specification<User> spec = UserSpecifications.bySearchCriteria(search);
Page<User> users = userRepository.findAll(spec, pageable); // 自动应用排序
return users.map(user -> modelMapper.map(user, UserDTO.class));
}? 关键注意事项
-
字段安全性：确保排序字段为白名单内属性，避免恶意传入
password,desc等敏感字段。建议在拦截器或Pageable包装器中校验getSort().stream().map(Sort.Order::getProperty)； -
空排序处理：若业务允许无排序，
Pageable.unpaged()可显式跳过排序逻辑； -
前端配合：前端应将用户选择的排序项（如“城市升序 → 性别降序”）拼接为合规
sort参数数组，避免手动拼字符串出错。
通过 Pageable，你只需声明式接收参数，即可零配置获得企业级分页+多字段排序能力——简洁、安全、可扩展。
