spring-web何时抛出BindException？如何在测试中触发该异常？

一、如何触发BindException #

现在常规的@Valid/@Validated参数校验确实会抛出MethodArgumentNotValidException，但BindException仍有特定触发场景：

• 手动使用WebRequestDataBinder绑定数据：在控制器中手动创建WebRequestDataBinder并绑定请求参数，当绑定失败（比如字段类型不匹配）时会抛出该异常。示例代码：

@GetMapping("/trigger-bind-exception")
public String triggerBindException(HttpServletRequest request) throws BindException {
    User user = new User();
    WebRequestDataBinder binder = new WebRequestDataBinder(user);
    // 将请求参数绑定到user对象
    binder.bind(new ServletWebRequest(request));
    binder.validate();
    if (binder.getBindingResult().hasErrors()) {
        throw new BindException(binder.getBindingResult());
    }
    return "success";
}

测试时请求该接口，传入不符合字段类型的参数（比如User的age是Integer类型，传age=abc），即可触发BindException。

• WebFlux中手动使用DefaultServerRequest绑定：在WebFlux场景下，手动调用DefaultServerRequest的绑定方法，当数据绑定失败时也会抛出BindException。示例：

@GetMapping("/webflux-trigger-bind")
public Mono<String> triggerWebFluxBindException(ServerRequest request) {
    return request.bodyToMono(User.class)
            .flatMap(user -> {
                WebExchangeDataBinder binder = new WebExchangeDataBinder(user);
                return binder.validate()
                        .doOnSuccess(bindingResult -> {
                            if (bindingResult.hasErrors()) {
                                throw new BindException(bindingResult);
                            }
                        })
                        .then(Mono.just("success"));
            });
}

发送不符合User字段规则的请求体，就能触发异常。

二、是否需要保留BindException处理器？ #

• 从Spring Framework 6.2的更新来看，官方已经移除了对BindException的默认处理逻辑，说明常规业务场景下这个异常的出现概率已经极低。
• 如果你的代码中没有手动数据绑定的逻辑（比如自定义参数解析器、手动处理请求参数绑定），那么应用几乎不会抛出BindException，此时可以移除对应的异常处理器，精简代码。
• 但如果存在手动绑定数据的场景，就需要保留该处理器来处理这类场景下的绑定错误。

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