Java中统一异常类设计模式示例_技术教程

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

在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_REQUE

ST).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);
  }
}

基本上就这些。通过继承结构+错误码枚举+全局处理器，实现异常的统一管理和响应，让系统更健壮、易维护。不复杂但容易忽略细节，比如异常信息的可读性和日志记录配合。