Java Spring Boot中高效处理成功与失败HTTP响应的最优方案

你提到的手动构建ResponseEntity确实会在多接口场景下产生重复冗余代码，下面是几种更高效的处理方式：

1. 利用Spring Data的Optional自动适配（最简方案） #

如果你的Repository返回Optional<T>，可以直接返回实体对象，结合自定义异常简化流程：

• 当Optional存在值时，Spring自动返回200 OK+实体内容
• 当Optional为空时，抛出自定义异常，后续通过全局处理器统一返回404 NOT_FOUND

示例代码：

@GetMapping("/{id}")
public Weather getWeatherRecordsById(@PathVariable Integer id){
    return mySpringDataJPARepository.findById(id)
            .orElseThrow(() -> new ResourceNotFoundException("Weather record not found with id: " + id));
}

2. 全局异常处理器（@RestControllerAdvice） #

通过全局异常捕获，统一处理各类异常的响应格式和状态码，彻底避免每个接口手动判断：

@RestControllerAdvice
public class GlobalExceptionHandler {

    // 处理资源不存在的自定义异常
    @ExceptionHandler(ResourceNotFoundException.class)
    public ResponseEntity<CustomErrorResponse> handleResourceNotFound(ResourceNotFoundException ex) {
        CustomErrorResponse error = new CustomErrorResponse(
                HttpStatus.NOT_FOUND.value(),
                ex.getMessage(),
                LocalDateTime.now()
        );
        return new ResponseEntity<>(error, HttpStatus.NOT_FOUND);
    }

    // 处理其他通用异常
    @ExceptionHandler(Exception.class)
    public ResponseEntity<CustomErrorResponse> handleGenericException(Exception ex) {
        CustomErrorResponse error = new CustomErrorResponse(
                HttpStatus.INTERNAL_SERVER_ERROR.value(),
                "An unexpected error occurred",
                LocalDateTime.now()
        );
        return new ResponseEntity<>(error, HttpStatus.INTERNAL_SERVER_ERROR);
    }
}

// 自定义异常类
public class ResourceNotFoundException extends RuntimeException {
    public ResourceNotFoundException(String message) {
        super(message);
    }
}

// 自定义错误响应体
public class CustomErrorResponse {
    private int statusCode;
    private String message;
    private LocalDateTime timestamp;

    // 构造器、getter/setter
}

3. 用AOP统一包装成功响应 #

如果需要给所有成功响应统一添加通用包装结构（比如包含状态码、消息、数据），可以用AOP环绕通知实现：

@Aspect
@Component
public class ResponseWrapperAspect {

    // 匹配所有@RestController下的方法
    @Around("within(@org.springframework.web.bind.annotation.RestController *)")
    public Object wrapResponse(ProceedingJoinPoint joinPoint) throws Throwable {
        Object result = joinPoint.proceed();
        // 自定义成功响应包装类
        return new SuccessResponse<>(HttpStatus.OK.value(), "Request successful", result);
    }
}

// 成功响应包装类
public class SuccessResponse<T> {
    private int statusCode;
    private String message;
    private T data;

    public SuccessResponse(int statusCode, String message, T data) {
        this.statusCode = statusCode;
        this.message = message;
        this.data = data;
    }

    // getter/setter
}

注意：这种方式需要确保接口不会直接返回ResponseEntity，否则会重复包装。若有特殊接口不需要包装，可通过自定义注解标记并在切面中排除。

4. 用@ResponseStatus简化状态码返回 #

对于不需要复杂响应体的场景，直接用@ResponseStatus标注方法或异常类：

// 创建接口成功返回201 Created
@PostMapping("/")
@ResponseStatus(HttpStatus.CREATED)
public Weather createWeather(@RequestBody Weather weather) {
    return mySpringDataJPARepository.save(weather);
}

// 自定义异常直接绑定404状态码
@ResponseStatus(HttpStatus.NOT_FOUND)
public class ResourceNotFoundException extends RuntimeException {
    public ResourceNotFoundException(String message) {
        super(message);
    }
}

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