Java 自定义异常怎么在业务状态不满足时拦截-java教程-PHP中文网

应使用自定义异常拦截业务状态不满足情形，核心是提前校验、主动抛出、精准捕获；需梳理非法可预判状态，定义带错误码的非检查型异常类，入口处集中校验并抛出，再通过@controlleradvice全局统一处理返回结构化结果。

java 自定义异常怎么在业务状态不满足时拦截

在业务状态不满足时用自定义异常拦截，核心是“提前发现 + 主动抛出 + 精准捕获”，不是等错误发生后再兜底，而是把校验逻辑前置，让异常成为业务规则的执行开关。

明确哪些状态需要拦截

先梳理清楚业务中哪些状态属于“非法但可预判”的情形，比如：

用户已注销，却尝试提交订单
订单当前状态是“已发货”，却调用“取消订单”接口
账户余额不足，却发起扣款操作
活动未开始或已结束，却允许参与抽奖

这些都不是系统故障，而是业务流程中的约束条件。它们适合用自定义异常来表达——既语义清晰，又便于统一拦截和响应。

定义带业务语义的异常类

继承 RuntimeException（非检查型），避免强制 throws 干扰正常方法签名。同时建议加入错误码字段，方便前端或日志识别：

public class BusinessException extends RuntimeException {
    private final int code;

    public BusinessException(int code, String message) {
        super(message);
        this.code = code;
    }

    public int getCode() {
        return code;
    }
}

再按场景细化子类，例如：

JavaStoryDevelop

你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在

下载

public class OrderStatusInvalidException extends BusinessException {
    public OrderStatusInvalidException(String message) {
        super(4001, "订单状态不合法: " + message);
    }
}

在关键节点主动校验并抛出

不要把校验逻辑散落在 service 方法里，推荐在入口处（如 Service 方法开头）集中判断。示例：

public void cancelOrder(Long orderId) {
    Order order = orderMapper.selectById(orderId);
    if (!"待支付".equals(order.getStatus())) {
        throw new OrderStatusInvalidException(
            "当前状态为 " + order.getStatus() + "，仅支持取消待支付订单");
    }
    // 后续取消逻辑...
}

这样一旦状态不满足，立刻中断执行，不会继续走后续可能引发数据不一致的操作。

全局统一拦截并返回友好结果

用 @ControllerAdvice 捕获自定义异常，转成标准响应格式：

@ExceptionHandler(BusinessException.class)
@ResponseBody
public Result> handleBusinessException(BusinessException e) {
    return Result.fail(e.getCode(), e.getMessage());
}

前端收到的是结构化错误码和提示，后端日志里也能按 code 快速归类问题，不需要翻堆栈找原因。