当前位置：首页 > 文章列表 > 文章 > java教程 > Java异常处理设计模式全解析

Java异常处理设计模式全解析

2025-12-04 17:52:48 0浏览收藏

在Java开发中，统一异常处理至关重要，它能显著提升代码可读性和维护性。本文深入探讨**Java统一异常处理设计模式**，旨在帮助开发者构建更健壮、易维护的系统。文章将详细介绍如何通过设计`BaseException`作为统一异常基类，结合业务异常类与`ErrorCode`枚举来有效管理错误码，避免硬编码，提升可维护性。同时，我们还将探讨如何在Spring Boot框架中巧妙运用`@ControllerAdvice`注解，实现全局异常处理，统一拦截并返回标准格式的错误响应，从而提升系统的稳定性和用户体验。通过本文的学习，你将掌握一套清晰的异常体系设计方法，更好地分离业务逻辑与错误处理逻辑，实现全局捕获和响应，为你的Java项目保驾护航。

通过设计BaseException作为统一异常基类，结合业务异常类与ErrorCode枚举管理错误码，并在Spring Boot中使用@ControllerAdvice实现全局异常处理，提升系统可维护性与一致性。

Java中统一异常类设计模式示例

在Java开发中，统一异常处理能提升代码可读性和维护性。通过设计一套清晰的异常体系，可以更好地分离业务逻辑与错误处理逻辑，便于全局捕获和响应。以下是常见的统一异常类设计模式示例。

定义基础异常类（BaseException）

创建一个自定义基础异常类，作为所有业务异常的父类，便于统一处理。

public class BaseException extends RuntimeException {
  private final String code;
  private final String message;

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

  public String getCode() { return code; }
  public String getMessage() { return message; }
}

定义具体业务异常类

基于BaseException扩展出不同场景的异常类型，比如用户相关、订单相关等。

public class UserNotFoundException extends BaseException {
  public UserNotFoundException(String userId) {
    super("USER_NOT_FOUND", "用户不存在: " + userId);
  }
}

public class OrderProcessingException extends BaseException {
  public OrderProcessingException(String orderId) {
    super("ORDER_PROCESS_FAILED", "订单处理失败: " + orderId);
  }
}

使用枚举管理错误码

将错误码集中管理，提高可维护性，避免硬编码。

public enum ErrorCode {
  USER_NOT_FOUND("USER_NOT_FOUND", "用户未找到"),
  INVALID_PARAM("INVALID_PARAM", "参数无效"),
  AUTH_FAILED("AUTH_FAILED", "认证失败");

  private final String code;
  private final String message;

  ErrorCode(String code, String message) {
    this.code = code;
    this.message = message;
  }

  public String getCode() { return code; }
  public String getMessage() { return message; }
}

// 使用示例
throw new BaseException(ErrorCode.INVALID_PARAM.getCode(), ErrorCode.INVALID_PARAM.getMessage());

结合Spring全局异常处理器

在Spring Boot项目中，使用@ControllerAdvice统一拦截自定义异常并返回标准格式。

@ControllerAdvice
public class GlobalExceptionHandler {

  @ResponseBody
  @ExceptionHandler(BaseException.class)
  public ResponseEntity> handleBaseException(BaseException e) {
    Map response = new HashMap<>();
    response.put("code", e.getCode());
    response.put("message", e.getMessage());
    return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(response);
  }

  @ExceptionHandler(Exception.class)
  public ResponseEntity> handleUnexpectedException(Exception e) {
    Map response = new HashMap<>();
    response.put("code", "INTERNAL_ERROR");
    response.put("message", "系统内部错误");
    return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(response);
  }
}