Spring Boot Controller中：抛出异常还是返回自定义对象更优？

优先选选项1：自定义异常+全局异常处理器 #

这个方案更贴合Spring Boot REST开发的最佳实践，理由如下：

• 关注点分离：把参数校验的异常抛出逻辑和业务逻辑分开，接口方法只需要专注处理正常业务，所有异常统一交给全局处理器处理，不用在每个接口里重复写错误返回的代码。
• 符合HTTP规范：参数非法属于客户端请求错误，对应HTTP 400 Bad Request状态码，全局处理器可以统一返回包含状态码、提示信息的标准错误响应，客户端能直接通过状态码判断请求是否合法，更符合RESTful设计思路。
• 扩展性强：后续新增其他类型的参数校验或业务异常，只需要新增对应的自定义异常，在全局处理器里加一个处理方法就行，不用修改所有接口的返回逻辑。

甚至可以进一步优化，用Spring Validation注解代替手动的if判断，代码更简洁：

@GetMapping("/user/{id}")
public UserResponseVM getIndividualUser(
        @PathVariable("id") 
        @NotNull(message = "Id不能为null") 
        @Min(value = 0, message = "Id不能小于0") 
        Long id) {
    // 执行业务逻辑，比如调用服务层获取用户信息
    return userService.getById(id);
}

搭配全局异常处理器统一处理校验异常：

@RestControllerAdvice
public class GlobalExceptionHandler {

    // 处理Validation注解抛出的参数校验异常
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ResponseEntity<ErrorResult> handleValidationError(MethodArgumentNotValidException ex) {
        String errorMsg = ex.getBindingResult().getFieldErrors()
                .stream()
                .map(FieldError::getDefaultMessage)
                .findFirst()
                .orElse("参数校验失败");
        ErrorResult result = new ErrorResult(400, errorMsg);
        return new ResponseEntity<>(result, HttpStatus.BAD_REQUEST);
    }

    // 处理自定义的BadRequestException
    @ExceptionHandler(BadRequestException.class)
    public ResponseEntity<ErrorResult> handleBadRequest(BadRequestException ex) {
        ErrorResult result = new ErrorResult(400, ex.getMessage());
        return new ResponseEntity<>(result, HttpStatus.BAD_REQUEST);
    }

    // 自定义错误响应类
    static class ErrorResult {
        private int code;
        private String message;

        public ErrorResult(int code, String message) {
            this.code = code;
            this.message = message;
        }

        // getter和setter省略
    }
}

选项2的问题 #

• 代码冗余：每个接口都要手动构建自定义返回对象，重复代码多，后期维护麻烦。
• 违背HTTP规范：参数非法却返回200状态码，客户端得解析响应体才能知道请求失败，增加了客户端的处理复杂度，也不符合RESTful用状态码标识请求结果的原则。
• 逻辑耦合：接口方法既要处理业务逻辑，又要写错误返回的逻辑，代码可读性差。

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