当将 @ExceptionHandler 从控制器内移至 @RestControllerAdvice 类后响应格式异常，通常因多个全局异常处理器冲突导致优先级不足，需显式设置 @Order 保证执行顺序。
当将 `@exceptionhandler` 从控制器内移至 `@restcontrolleradvice` 类后响应格式异常，通常因多个全局异常处理器冲突导致优先级不足，需显式设置 `@order` 保证执行顺序。
在 Spring Boot 3 中，@RestControllerAdvice 是实现全局异常统一处理的标准方式。但若项目中存在多个 @RestControllerAdvice 类（如你结构中的 RestExceptionHandler、ValidationExceptionHandler 等），Spring 会按注册顺序或默认优先级调用它们——而 Spring Boot 内置的 DefaultErrorAttributes 或其他自定义异常处理器（例如处理 RuntimeException 的通用兜底类）可能抢先捕获了 MethodArgumentNotValidException，导致你的验证处理器未被触发，最终返回默认的 RFC 7807 格式错误响应（即含 type/title/detail 的 JSON）。
根本原因在于：MethodArgumentNotValidException 是一种预绑定校验异常，它由 Spring MVC 的 RequestResponseBodyMethodProcessor 在参数解析阶段抛出，且可被多个 @ExceptionHandler 方法匹配。若多个 @RestControllerAdvice 类均声明了对该异常的处理逻辑，Spring 会依据其Bean 的排序（Order） 决定执行优先级；未显式指定时，默认顺序不确定，高优先级的处理器（如更宽泛的 Exception 捕获器）可能“吞掉”该异常。
✅ 正确做法是为 ValidationExceptionHandler 显式声明最高优先级：
package com.example.my_app.exception;
import org.springframework.core.Ordered;
import org.springframework.core.annotation.Order;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.MethodArgumentNotValidException;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import java.util.HashMap;
import java.util.Map;
@Order(Ordered.HIGHEST_PRECEDENCE) // ← 关键：确保最先执行
@RestControllerAdvice
public class ValidationExceptionHandler {
@ExceptionHandler(MethodArgumentNotValidException.class)
public ResponseEntity<Object> handleValidationException(MethodArgumentNotValidException ex) {
Map<String, String> errors = new HashMap<>();
ex.getBindingResult().getFieldErrors().forEach(error ->
errors.put(error.getField(), error.getDefaultMessage())
);
return ResponseEntity.badRequest().body(errors);
}
}? 注意事项与最佳实践：
- ✅ 必须添加 @Order 注解：仅靠 @RestControllerAdvice 不足以保证执行顺序，尤其在多模块或多异常处理器场景下；
- ✅ 包扫描需覆盖该类：确认 ValidationExceptionHandler 所在包（com.example.my_app.exception）已被 Spring Boot 主类的 @SpringBootApplication 扫描到（默认会扫描同包及子包，若主类位于 com.example.my_app 则符合）；
- ⚠️ 避免重复捕获：检查其他 @RestControllerAdvice 类（如 RestExceptionHandler）是否也声明了 @ExceptionHandler(MethodArgumentNotValidException.class)，若有，请删除或将其 @Order 设为更低优先级（如 @Order(Ordered.LOWEST_PRECEDENCE)）；
- ✅ 推荐细化响应结构：生产环境建议封装标准错误响应体（如包含 timestamp、path、code 字段），而非裸 Map，提升 API 一致性；
- ✅ 测试验证：使用 curl 或 Postman 发送含非法字段的请求（如短密码、非法邮箱），确认返回为 { "password": "...", "username": "..." } 而非 RFC 7807 格式。
通过以上配置，ValidationExceptionHandler 将作为校验异常的专属、高优处理器，精准拦截并格式化所有控制器中的 @Valid 校验失败，真正实现跨控制器复用与响应标准化。
