使用 @controlleradvice 配合 @exceptionhandler 捕获 httpmessagenotreadableexception 即可拦截反序列化器抛出的异常。spring mvc 在 json 解析阶段若遇到格式错误或类型不匹配,会抛出该异常,通过全局处理器统一返回自定义的 json 错误响应,避免暴露堆栈信息。

@RestControllerAdvice 如何拦截解析失败
直接继承 ResponseEntityExceptionHandler 或实现 HandlerExceptionResolver 接口,并在方法上标注 @ExceptionHandler(HttpMessageNotReadableException.class)。当请求体包含非法 JSON 时,Spring 内部转换器触发异常,该方法会被调用并接管响应输出。

import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import org.springframework.http.converter.HttpMessageNotReadableException;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(HttpMessageNotReadableException.class)
public ResponseEntity<String> handleBadRequest(HttpMessageNotReadableException ex) {
return ResponseEntity.badRequest().body("JSON parsing failed: " + ex.getMostSpecificCause());
}
}
如何处理嵌套对象中的字段缺失
针对嵌套对象中必填字段缺失导致的反序列化失败,同样由 HttpMessageNotReadableException覆盖。此时 getMostSpecificCause() 通常指向具体的 MismatchedInputException 或 InvalidFormatException,提取其消息可精准定位缺失字段。

import com.fasterxml.jackson.databind.exc.MismatchedInputException;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import org.springframework.http.converter.HttpMessageNotReadableException;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(HttpMessageNotReadableException.class)
public ResponseEntity<String> handleNestedFieldMissing(HttpMessageNotReadableException ex) {
Throwable cause = ex.getMostSpecificCause();
if (cause instanceof MismatchedInputException) {
return ResponseEntity.badRequest().body("Missing required field in nested object");
}
return ResponseEntity.badRequest().body("Unexpected JSON structure");
}
}
基于输入 {"user": {}} 的具体问题
当输入为 {"user": {}} 且目标类 User 包含非空 name 字段时,反序列化器会因缺少必需属性而抛出异常。全局处理器捕获后,通过检查异常链中的具体原因,可以区分是结构错误还是字段缺失,从而返回明确的错误提示。


















