java 自定义异常层次树的设计核心是建立以 runtimeexception 为根的继承结构，确保业务异常具备非检查性并支持链式传递。具体做法是定义一个基类 baseexception 继承自 runtimeexception，并在其中封装错误码（code）和描述信息（message）。子类通过构造函数调用父类方法，将具体的业务场景映射到唯一的错误码上，从而实现异常的标准化处理与统一捕获。
如何设计统一的异常基类
设计异常基类的关键在于确定其继承来源和内部字段。基类应直接继承 RuntimeException，这样在抛出时无需强制声明或捕获，符合现代 Java 开发中“检查型异常仅用于不可恢复的外部错误”的最佳实践。基类内部必须包含两个核心字段：一个是整型的 code，用于前端或日志系统快速识别错误类型；另一个是字符串类型的 message，用于展示给用户或记录详细堆栈。构造函数的设计应支持传入错误码、消息以及原始的 Throwable 原因对象，以便保留完整的异常链。
public class BaseException extends RuntimeException {
private final int code;
public BaseException(int code, String message) {
super(message);
this.code = code;
}
public BaseException(int code, String message, Throwable cause) {
super(message, cause);
this.code = code;
}
public int getCode() {
return code;
}
}
上述代码定义了标准的异常基类。在实际使用中，开发者只需创建子类并指定固定的错误码即可。例如，当需要区分不同模块的错误时，可以在基类基础上增加模块标识，或者直接在子类中硬编码错误码。这种设计使得所有自定义异常都拥有统一的接口，便于在全局异常处理器（如 Spring 的 @ControllerAdvice）中进行统一转换和返回。
如何构建细分的业务异常子类
构建业务异常子类的目的是将通用的基类行为具体化到特定的业务场景中。每个子类代表一种具体的失败情况，如参数校验失败、资源未找到或权限不足。子类通常不添加新的逻辑，而是通过构造函数调用父类的构造函数，传入预定义的常量错误码和对应的提示信息。这种模式确保了异常信息的结构化，同时保持了代码的简洁性。开发者可以根据业务模块进一步划分包结构，例如 com.example.exception.user 下存放用户相关的异常，com.example.exception.order 下存放订单相关的异常。
public class UserNotFoundException extends BaseException {
public static final int CODE = 404001;
public UserNotFoundException(String userId) {
super(CODE, "User not found: " + userId);
}
}
public class OrderInvalidException extends BaseException {
public static final int CODE = 500001;
public OrderInvalidException(String reason) {
super(CODE, "Order invalid: " + reason);
}
}
通过这种方式，每个异常类都携带了明确的身份标识。在处理这些异常时，可以通过 instanceof 判断或 catch 块的具体类型来执行不同的业务逻辑。由于继承了 RuntimeException，这些异常可以跨层传递，无需在方法签名中声明 throws，从而减少了样板代码。同时，错误码的唯一性保证了在分布式系统中能够准确定位问题根源。
全局异常处理器如何基于错误码响应
全局异常处理器的作用是拦截所有未被捕获的自定义异常，并将其转换为标准化的 HTTP 响应或 JSON 数据。处理器通常使用 @RestControllerAdvice 注解配合 @ExceptionHandler 来实现。在处理逻辑中，首先获取异常实例，提取其 code 和 message 字段，然后结合 HTTP 状态码生成最终响应。这种机制避免了在每个 Controller 方法中编写重复的 try-catch 块，实现了关注点分离。对于未知的异常，处理器还可以提供默认的 fallback 策略，确保系统稳定性。
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(BaseException.class)
public ResponseEntity<result> handleBaseException(BaseException ex) {
Result result = new Result();
result.setCode(ex.getCode());
result.setMessage(ex.getMessage());
result.setSuccess(false);
// 根据 code 映射 HTTP 状态码
HttpStatus status = mapCodeToStatus(ex.getCode());
return new ResponseEntity(result, status);
}
private HttpStatus mapCodeToStatus(int code) {
if (code == 404001) return HttpStatus.NOT_FOUND;
if (code == 500001) return HttpStatus.BAD_REQUEST;
return HttpStatus.INTERNAL_SERVER_ERROR;
}
}</result>
该处理器展示了如何将自定义异常与 Web 层集成。当 UserNotFoundException 被抛出时，它会被 handleBaseException 捕获，因为它是 BaseException 的子类。处理器提取出错误码 404001，并将其映射为 HTTP 404 状态码，同时返回包含错误信息的 JSON 体。这种设计使得 API 响应格式统一，前端可以依据 code 字段进行统一的错误提示处理，而无需解析复杂的堆栈信息。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
