如何调试Spring中JSON转Java对象反序列化错误导致的400 Bad Request？

以下是几种实用方法，可帮你定位这类请求反序列化或参数校验失败的具体问题：

1. 开启核心组件的调试日志 #

通过调整日志级别，让Spring Web和Jackson组件输出调试信息，直接暴露反序列化或参数解析的错误细节。在配置文件（application.properties或application.yml）中添加：

# 开启Spring Web请求处理的调试日志
logging.level.org.springframework.web=DEBUG
# 开启Jackson反序列化的调试日志，捕获JSON解析错误
logging.level.com.fasterxml.jackson.databind=DEBUG

配置后，日志会输出具体错误信息，比如"无法将字符串'abc'转换为Integer类型"或"缺少必填字段'userId'"。

2. 自定义全局异常处理器 #

针对请求参数校验和JSON反序列化失败的异常，编写全局异常处理器，将错误信息直接返回给调用端，方便快速定位问题：

@RestControllerAdvice
public class GlobalBadRequestHandler {

    // 处理参数校验失败（如@Valid注解触发的错误）
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ResponseEntity<Map<String, String>> handleValidationErrors(MethodArgumentNotValidException ex) {
        Map<String, String> errorDetails = new HashMap<>();
        ex.getBindingResult().getAllErrors().forEach(error -> {
            String fieldName = ((FieldError) error).getField();
            String errorMessage = error.getDefaultMessage();
            errorDetails.put(fieldName, errorMessage);
        });
        return new ResponseEntity<>(errorDetails, HttpStatus.BAD_REQUEST);
    }

    // 处理JSON反序列化失败（如数据类型不匹配、格式错误）
    @ExceptionHandler(HttpMessageNotReadableException.class)
    public ResponseEntity<String> handleJsonParseErrors(HttpMessageNotReadableException ex) {
        // 从根异常中提取具体错误信息
        String rootCauseMessage = ex.getCause() != null ? ex.getCause().getMessage() : ex.getMessage();
        return new ResponseEntity<>(rootCauseMessage, HttpStatus.BAD_REQUEST);
    }
}

添加这个处理器后，前端会收到结构化的错误信息，比如字段名对应错误提示，或者具体的JSON解析失败原因。

3. 启用Bean Validation校验 #

在请求实体类的字段上添加校验注解，配合控制器方法的@Valid注解，强制触发参数校验并返回具体错误：

// 请求实体类
public class UserCreateRequest {
    @NotNull(message = "用户ID不能为空")
    private Long userId;
    @NotBlank(message = "用户名不能为空")
    private String username;
    @Min(value = 18, message = "年龄不能小于18岁")
    private Integer age;

    // getter、setter方法
}

// 控制器方法
@PostMapping("/users")
public ResponseEntity<User> createUser(@Valid @RequestBody UserCreateRequest request) {
    // 业务逻辑处理
}

当请求缺少必填字段或字段不符合规则时，会触发MethodArgumentNotValidException，被全局处理器捕获并返回字段级的错误信息。

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