spring boot中统一处理参数校验异常需定义validationexception，controller中手动提取bindingresult抛出，或通过@controlleradvice全局捕获methodargumentnotvalidexception和constraintviolationexception并转换。
<p>在 Spring Boot 项目中，使用 <code>@Valid</code> 或 <code>@Validated</code> 进行参数校验后，若校验失败，默认会将错误信息存入 <code>BindingResult</code>。要统一转换为自定义异常（如 <code>ValidationException</code>），关键是在 Controller 层或全局异常处理器中提取并封装这些错误。</p>
<h3>1. 定义自定义 ValidationException</h3>
<p>先创建一个运行时异常类，携带校验错误详情：</p>
<font color="#888">
<pre class="brush:php;toolbar:false;"><code>public class ValidationException extends RuntimeException {
private final List<string> errors;
public ValidationException(List<string> errors) {
super("参数校验失败: " + String.join("; ", errors));
this.errors = Collections.unmodifiableList(errors);
}
public List<string> getErrors() {
return errors;
}
}</string></string></string></code>
2. 在 Controller 中手动提取 BindingResult 并抛出
适用于需要精细控制的接口，比如校验后还需做其他逻辑判断：
- 确保
BindingResult紧跟在被校验参数之后（Spring 要求） - 调用
hasErrors()判断是否失败 - 遍历
getFieldErrors()或getGlobalErrors()提取提示信息
<code>@PostMapping("/user")
public ResponseEntity> createUser(@Valid @RequestBody User user, BindingResult result) {
if (result.hasErrors()) {
List<string> messages = result.getFieldErrors().stream()
.map(error -> error.getField() + ": " + error.getDefaultMessage())
.collect(Collectors.toList());
throw new ValidationException(messages);
}
return ResponseEntity.ok(userService.save(user));
}</string></code>
3. 使用 @ControllerAdvice 统一拦截并转换
更推荐的方式：全局捕获 MethodArgumentNotValidException（对应 @Valid）和 ConstraintViolationException（对应 @Validated 注解在方法参数上），自动转为 ValidationException：
<code>@ControllerAdvice
public class ValidationExceptionHandler {
@ExceptionHandler(MethodArgumentNotValidException.class)
public ResponseEntity<object> handleMethodArgumentNotValid(
MethodArgumentNotValidException ex, HttpServletRequest request) {
List<string> errors = ex.getBindingResult().getFieldErrors().stream()
.map(e -> e.getField() + " " + e.getDefaultMessage())
.collect(Collectors.toList());
throw new ValidationException(errors);
}
@ExceptionHandler(ConstraintViolationException.class)
public ResponseEntity<object> handleConstraintViolation(
ConstraintViolationException ex, HttpServletRequest request) {
List<string> errors = ex.getConstraintViolations().stream()
.map(violation -> violation.getPropertyPath() + ": " + violation.getMessage())
.collect(Collectors.toList());
throw new ValidationException(errors);
}
}</string></object></string></object></code>
4. 补充建议：统一错误响应结构（可选）
如果项目要求返回标准 JSON 错误格式（如 { "code": 400, "message": "...", "details": [...] }），可在全局异常处理器中直接返回 ResponseEntity，而不抛出 ValidationException；但若已有统一异常处理链路（比如所有业务异常都由顶层切面捕获并包装），则保持抛出 ValidationException 更利于一致性。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
