在Java项目中，异常信息是否清晰直接影响排查效率。使用Custom RuntimeException可以将业务语义融入异常本身，避免调用层面对模糊错误进行猜测。下面通过具体设计技巧说明如何实现这一目标。
为什么需要自定义运行时异常
Java内置的RuntimeException过于通用，例如NullPointerException只说明空指针，却无法表达是哪个业务对象为空。自定义异常可携带业务含义，提升可读性。
设计原则
- 命名以Exception结尾，体现具体错误场景，如OrderNotFoundException
- 继承RuntimeException，避免强制try-catch影响代码流畅性
- 提供多构造方法，支持消息、原因异常、错误码等组合
基础自定义异常示例
下面是一个通用的业务异常基类，其他具体异常可继承它：
public class BusinessRuntimeException extends RuntimeException {
// 错误码，用于前后端约定
private final String errorCode;
public BusinessRuntimeException(String errorCode, String message) {
super(message);
this.errorCode = errorCode;
}
public BusinessRuntimeException(String errorCode, String message, Throwable cause) {
super(message, cause);
this.errorCode = errorCode;
}
public String getErrorCode() {
return errorCode;
}
}
具体业务异常设计
针对订单不存在的场景，可以定义更明确的异常类：
public class OrderNotFoundException extends BusinessRuntimeException {
public OrderNotFoundException(Long orderId) {
super("ORDER_404", "订单不存在，订单ID: " + orderId);
}
public OrderNotFoundException(Long orderId, Throwable cause) {
super("ORDER_404", "订单不存在，订单ID: " + orderId, cause);
}
}
在业务代码中使用
当查询订单为空时，直接抛出自定义异常，调用方根据类型做处理：
public Order findOrder(Long id) {
Order order = orderRepository.selectById(id);
if (order == null) {
throw new OrderNotFoundException(id);
}
return order;
}
提升可读性的配套技巧
| 技巧 | 说明 |
|---|---|
| 错误码常量类 | 将errorCode集中管理，避免散落字符串 |
| 重写toString | 在异常中补充上下文字段，方便日志打印 |
| 全局异常处理器 | 用Spring的ControllerAdvice转换异常为友好响应 |
全局处理片段
@ControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(BusinessRuntimeException.class)
public ResponseEntity<String> handleBiz(Exception e) {
return ResponseEntity.badRequest().body(e.getMessage());
}
}
注意事项
自定义异常不要过度细分，否则类爆炸；也不要只用一层基类而失去语义。按业务域划分即可。
通过上述方式，Custom RuntimeException让Java异常具备自解释能力，团队协作和线上排查都更高效。
Custom_RuntimeExceptionJava异常设计异常可读性修改时间：2026-07-27 23:00:24