spring boot 全局异常处理捕获属性绑定异常，核心在于使用 @controlleradvice 配合 @exceptionhandler 拦截 bindexception（表单提交）或 methodargumentnotvalidexception（json 校验）。具体做法是定义一个全局异常处理器类，在其中编写处理方法，通过 bindingresult 或 objecterror 提取具体的字段错误信息，并封装为统一的 json 响应返回给前端。
@ControllerAdvice 如何统一拦截绑定错误？
要实现全局拦截，需要创建一个被 @RestControllerAdvice 或 @ControllerAdvice 注解的类。在这个类中，定义一个方法并使用 @ExceptionHandler 指定要捕获的异常类型。对于表单数据绑定失败，Spring MVC 会抛出 BindException；对于 JSON 反序列化及校验失败，会抛出 MethodArgumentNotValidException。这两个异常都实现了 BindingResult 接口相关的错误收集机制，因此可以在 handler 方法中直接获取错误列表。
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.validation.BindException;
import org.springframework.validation.FieldError;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import java.util.HashMap;
import java.util.Map;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(BindException.class)
public ResponseEntity<Map<String, Object>> handleBindException(BindException ex) {
Map<String, Object> body = new HashMap<>();
body.put("status", 400);
body.put("error", "Parameter Binding Error");
Map<String, String> errors = new HashMap<>();
for (FieldError fieldError : ex.getBindingResult().getFieldErrors()) {
errors.put(fieldError.getField(), fieldError.getDefaultMessage());
}
body.put("details", errors);
return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(body);
}
}
上述代码展示了如何处理表单绑定异常。当请求参数无法正确映射到 Controller 方法的参数对象时，BindException 会被触发。代码遍历 ex.getBindingResult().getFieldErrors()，将每个字段的错误消息存入 errors Map 中，最终返回包含状态码、错误描述和详细字段错误的 JSON 结构。这种方式确保了所有绑定错误都能以一致的格式返回。
JSON 校验异常 MethodArgumentNotValidException 怎么区分处理？
在处理 RESTful API 时，通常接收的是 JSON 数据。如果 JSON 数据符合语法但违反了实体类上的校验注解（如 @NotNull, @Size），Spring 会抛出 MethodArgumentNotValidException。与 BindException 不同，这个异常不直接继承自 BindingResult，而是需要通过 getBindingResult() 方法获取内部的 BindingResult 对象来访问错误信息。处理方式与表单绑定类似，但需要确保 Controller 方法参数前加 @Valid 或 @Validated 才能触发校验。
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.validation.MethodArgumentNotValidException;
import org.springframework.validation.FieldError;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import java.util.HashMap;
import java.util.Map;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(MethodArgumentNotValidException.class)
public ResponseEntity<Map<String, Object>> handleValidationException(MethodArgumentNotValidException ex) {
Map<String, Object> body = new HashMap<>();
body.put("status", 400);
body.put("error", "Validation Failed");
Map<String, String> errors = new HashMap<>();
for (FieldError fieldError : ex.getBindingResult().getFieldErrors()) {
errors.put(fieldError.getField(), fieldError.getDefaultMessage());
}
body.put("details", errors);
return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(body);
}
}
这段代码专门处理 JSON 校验异常。关键点在于调用 ex.getBindingResult().getFieldErrors() 来获取错误列表。这与处理 BindException 的逻辑几乎一致，只是入口点不同。在实际项目中，可以将这两段逻辑合并到一个通用的私有方法中，或者通过判断异常类型来复用相同的错误组装逻辑，避免代码重复。确保在对应的 DTO 类上添加了 JSR-303/JSR-380 校验注解，并且 Controller 方法参数使用了 @Valid，这样框架才会自动进行校验并抛出此异常。
当绑定错误中包含空值或缺失字段时，默认行为是什么？
当请求中缺少必填字段或字段值为 null 时，如果实体类中该字段标注了 @NotNull 或 @NotBlank，校验器会生成一条错误记录。默认情况下，FieldError.getDefaultMessage() 返回的是 Spring Validation 提供的国际化消息，例如 "must not be null" 或 "must not be blank"。如果开发者没有在 messages.properties 文件中自定义这些消息，前端收到的就是英文默认提示。此外，如果字段类型不匹配（如期望 Integer 却收到字符串），也会触发绑定异常，此时错误信息通常指出类型转换失败。这些情况都会导致 BindException 或 MethodArgumentNotValidException 被抛出，从而进入全局异常处理器。
