Spring中Pageable解析错误返回500，如何改为返回400？

测试人员发送请求：

curl -X 'GET' 'http://zones:26081/zones/vehicles-by-day?date=2023-05-20&page=0&size=10&sort=string'

收到500错误响应：

{"type":"about:blank","title":"Internal Server Error","status":500,"detail":"No property 'string' found for type 'VehiclesByDayEntity'","instance":"/zones/vehicles-by-day"}

合理预期应返回400（Bad Request），因为org.springframework.data.domain.Pageable解析失败属于请求参数错误。

相关@RestController代码片段：

import org.springframework.data.domain.Pageable;
import org.springframework.data.web.PageableDefault;
...
@GetMapping(value = "/vehicles-by-day", produces = MediaType.APPLICATION_JSON_VALUE)
ResponseEntity<VehiclesByDay200Response> getVehiclesByDay(
        @Parameter(name = "date", description = "The date vehicles by day which for")
        @RequestParam(value = "date", required = false) LocalDate date,
        @Parameter(name = "pageable", in = ParameterIn.QUERY)
        @PageableDefault Pageable pageable
);

核心疑问：

1. 能否拦截该解析错误并返回400状态？
2. 当请求中日期格式错误（如date=2023-05-aa）时会返回400，为何Pageable的处理逻辑不同？

1. 拦截Pageable解析错误返回400的两种方式 #

方式一：全局异常处理器捕获查询阶段异常 #

直接拦截PropertyReferenceException（即报错中提示的"找不到实体属性"异常），将其转换为400响应：

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(PropertyReferenceException.class)
    public ResponseEntity<ErrorResponse> handlePropertyReferenceException(PropertyReferenceException ex) {
        ErrorResponse error = new ErrorResponse(
                HttpStatus.BAD_REQUEST.value(),
                "无效排序参数",
                ex.getMessage(),
                RequestContextHolder.getRequestAttributes() != null ? 
                ((ServletRequestAttributes) RequestContextHolder.getRequestAttributes()).getRequest().getRequestURI() : 
                "/zones/vehicles-by-day"
        );
        return new ResponseEntity<>(error, HttpStatus.BAD_REQUEST);
    }

    // 自定义错误响应体，和现有报错格式对齐
    static class ErrorResponse {
        private int status;
        private String title;
        private String detail;
        private String instance;

        // 构造方法、getter/setter省略
    }
}

方式二：参数解析阶段提前校验排序字段 #

通过配置Spring Data的参数解析器，在参数绑定阶段就校验排序字段的合法性，避免到查询阶段才抛出异常：

@Configuration
public class WebConfig implements WebMvcConfigurer {

    @Autowired
    private EntityManager entityManager;

    @Override
    public void addArgumentResolvers(List<HandlerMethodArgumentResolver> resolvers) {
        // 配置排序参数解析器，添加字段校验逻辑
        SortHandlerMethodArgumentResolver sortResolver = new SortHandlerMethodArgumentResolver();
        sortResolver.setSortParameter("sort");
        sortResolver.setValidator((property, type) -> {
            try {
                // 校验字段是否属于目标实体类
                entityManager.getMetamodel().entity(type).getAttribute(property);
                return true;
            } catch (IllegalArgumentException e) {
                return false;
            }
        });

        // 配置分页参数解析器，依赖上面的排序解析器
        PageableHandlerMethodArgumentResolver pageableResolver = new PageableHandlerMethodArgumentResolver(sortResolver);
        resolvers.add(pageableResolver);
    }
}

这种方式会在参数解析阶段抛出IllegalArgumentException，被Spring默认的参数异常处理器捕获后返回400。

2. 日期错误与Pageable错误返回状态不同的原因 #

两者的错误触发阶段完全不同：

• 日期参数错误：LocalDate类型参数由Spring MVC的ConversionService在参数绑定阶段处理，格式错误会直接抛出ConversionFailedException，属于请求参数本身非法，Spring默认将这类异常映射为400响应。
• Pageable排序字段错误：Pageable的解析由Spring Data的专用解析器完成，但它只负责解析分页/排序参数的格式，不会校验字段是否属于实体类。直到数据查询阶段（调用JPA Repository方法时），才会抛出PropertyReferenceException，这个异常属于业务执行环节的错误，Spring默认映射为500响应。

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