Spring非@RequestBody场景下@ControllerAdvice校验异常处理不触发
根因定位
文件上传场景本身是multipart/form-data格式,这类请求不支持通过@RequestBody绑定(@RequestBody会将整个请求体作为字节流反序列化,无法正确解析multipart格式的文件分片),因此必须采用默认的modelAttribute绑定方式,而两种绑定机制的流程差异,就是全局异常处理器未触发的核心原因,和自定义校验器逻辑无关:
- 带
@RequestBody的入参:由RequestResponseBodyMethodProcessor组件统一处理,完成JSON反序列化、参数校验后,只要校验不通过就会直接抛出MethodArgumentNotValidException异常,该异常会被Spring内置的异常处理体系捕获,触发你重写的handleMethodArgumentNotValid方法。 - 不带
@RequestBody的表单/多部分文件上传入参:由ServletModelAttributeMethodProcessor组件统一处理,这类入参完成校验后,Spring不会主动抛出任何校验异常,会把所有校验错误直接封装到紧接入参位置的BindingResult对象中,透传到接口方法内部。
你现在的接口方法里紧跟入参声明了BindingResult bindingResult,本质是告知Spring“我要在方法内部自行处理校验错误”,因此整个流程全程不会触发异常抛出,全局异常处理器自然无法捕获。
认知澄清
@Valid注解本身只负责标记需要触发校验,不会主动决定校验失败后的处理逻辑,校验失败后是抛异常还是把结果塞到BindingResult,完全由对应的参数绑定组件决定。- 你写的
ProductImageConstraint自定义校验器不存在逻辑问题:注解的@Target同时覆盖了字段、类型使用场景,完全可以支持List泛型内的MultipartFile元素的嵌套校验,校验流程可以正常触发,和本次异常未触发的问题无关。 - 你当前在接口内部手动循环打印校验错误的逻辑,就是直接读取了被塞在BindingResult里的错误信息,这和Spring的设计是匹配的,不是框架bug。
修复方案
- 方案1:保留当前BindingResult的手动处理逻辑,直接在接口方法内部判断存在校验错误时,按照统一的错误格式构造响应返回即可,不需要依赖全局异常处理器拦截。
- 方案2:如果希望全局异常处理器统一接管所有场景的校验错误,直接删掉接口方法参数列表里的
BindingResult bindingResult。此时modelAttribute场景下的校验失败会触发BindException抛出,你需要在全局异常处理器中额外重写handleBindException方法,复用现有的错误格式化逻辑即可完成统一处理。
内容的提问来源于stack exchange,提问作者La Hai
相关产品推荐
相关产品推荐

