如何在服务层手动抛出MethodArgumentNotValidException复用控制器异常处理？

我明白你想要的效果：在服务层验证带有Bean Validation注解的对象时，也能像控制器用@Valid那样，让@RestControllerAdvice的全局异常处理器捕获并处理MethodArgumentNotValidException。直接手动抛这个异常不行的核心原因是，它需要携带完整的验证错误信息（通过BindingResult），空抛的话全局处理器拿不到错误详情，自然达不到预期效果。

这里给你两种可行的方案，你可以根据场景选择：

方案一：手动验证并构建MethodArgumentNotValidException抛出 #

这种方式完全对齐控制器@Valid的异常类型，不需要修改全局处理器的现有逻辑：

1. 首先在服务层注入Spring的Validator：

@Service
public class YourBusinessService {

    private final Validator validator;

    // 构造方法注入Validator（Spring会自动提供实现）
    public YourBusinessService(Validator validator) {
        this.validator = validator;
    }

2. 在需要验证的方法里执行验证，把错误转换成FieldError并构建BindingResult，最后抛出异常：

public void handleValidatedObject(YourValidatedDto dto) {
        // 执行Bean Validation验证
        Set<ConstraintViolation<YourValidatedDto>> violations = validator.validate(dto);
        
        if (!violations.isEmpty()) {
            // 将ConstraintViolation转换成Spring MVC的FieldError格式
            List<FieldError> fieldErrors = violations.stream()
                    .map(violation -> new FieldError(
                            dto.getClass().getName(),
                            violation.getPropertyPath().toString(),
                            violation.getMessage()
                    ))
                    .collect(Collectors.toList());
            
            // 构建BindingResult来携带错误信息
            BindingResult bindingResult = new BeanPropertyBindingResult(dto, dto.getClass().getSimpleName());
            fieldErrors.forEach(bindingResult::addError);
            
            // 抛出和控制器@Valid完全一致的异常
            throw new MethodArgumentNotValidException(null, bindingResult);
        }

        // 后续业务逻辑...
    }
}

这样你的ExceptionHandlerController里处理MethodArgumentNotValidException的逻辑完全不需要改动，就能直接处理服务层抛出的这个异常，返回和控制器验证失败一致的响应。

方案二：用@Validated让Spring自动验证服务层方法参数 #

这种方式更简洁，不需要手动写验证逻辑，但需要额外处理ConstraintViolationException：

1. 在服务类上标注@Validated，并在方法参数上用@Valid：

@Service
@Validated // 必须标注这个注解，参数上的@Valid才会生效
public class YourBusinessService {

    public void handleValidatedObject(@Valid YourValidatedDto dto) {
        // 业务逻辑...
        // 如果dto验证不通过，Spring会自动抛出ConstraintViolationException
    }
}

2. 在全局异常处理器里添加对ConstraintViolationException的处理，把错误转换成和MethodArgumentNotValidException一致的响应格式：

@RestControllerAdvice
public class ExceptionHandlerController {

    // 原有处理控制器@Valid的逻辑
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ResponseEntity<Map<String, String>> handleValidationExceptions(MethodArgumentNotValidException ex) {
        Map<String, String> errors = new HashMap<>();
        ex.getBindingResult().getAllErrors().forEach((error) -> {
            String fieldName = ((FieldError) error).getField();
            String errorMessage = error.getDefaultMessage();
            errors.put(fieldName, errorMessage);
        });
        return new ResponseEntity<>(errors, HttpStatus.BAD_REQUEST);
    }

    // 新增处理服务层验证的逻辑
    @ExceptionHandler(ConstraintViolationException.class)
    public ResponseEntity<Map<String, String>> handleServiceValidationExceptions(ConstraintViolationException ex) {
        Map<String, String> errors = new HashMap<>();
        ex.getConstraintViolations().forEach(violation -> {
            String fieldName = violation.getPropertyPath().toString();
            String errorMessage = violation.getMessage();
            errors.put(fieldName, errorMessage);
        });
        return new ResponseEntity<>(errors, HttpStatus.BAD_REQUEST);
    }
}

两种方案都能实现你想要的效果：服务层验证失败时，全局异常处理器返回统一格式的错误响应。如果想完全复用原有控制器的异常处理逻辑，方案一更合适；如果想减少手动代码，方案二更简洁。

内容的提问来源于stack exchange，提问作者Mário Sérgio Esteves Alvial