Java 中业务代码中怎么抛出自定义的业务异常-java教程-PHP中文网

java业务异常应继承runtimeexception，主动抛出以表达业务语义；提供多构造方法支持消息、错误码、异常包装；service层在逻辑校验点提前抛出；统一用@controlleradvice处理并返回结构化json；区分业务异常（info/warn）与系统异常（error）。

java 中业务代码中怎么抛出自定义的业务异常

在 Java 业务代码中，抛出自定义业务异常的核心是：定义一个继承自 RuntimeException 的异常类（非检查异常），并在需要的地方用 throw new XxxException(...) 主动抛出。这样既避免强制 try-catch 干扰业务流程，又能清晰表达业务语义。

定义自定义业务异常类

通常建议继承 RuntimeException，不强制上层处理，符合“业务异常非系统故障”的定位。可提供多种构造方法增强可用性：

只传消息字符串（便于日志和前端提示）
传消息 + 原始异常（用于包装底层异常，保留堆栈）
支持错误码（如订单异常、库存异常等不同场景区分）

示例：

public class BusinessException extends RuntimeException {
    private final int code;

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

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

    public BusinessException(String message, Throwable cause) {
        super(message, cause);
        this.code = 400;
    }

    public int getCode() {
        return code;
    }
}

在 Service 层按业务规则主动抛出

不要等到 NPE 或 SQL 异常发生才被动响应。应在逻辑判断点提前拦截并抛出，让异常成为业务校验的一部分：

javascript-pro

专注现代 ECMAScript、异步编程、性能优化和全栈的 JavaScript 专家，适用于现代开发

下载

参数非法（如手机号格式不对、金额为负）
状态不满足（如订单已支付，不能再取消）
资源不存在或不可用（如商品已下架、库存不足）

示例：

public void cancelOrder(Long orderId) {
    Order order = orderMapper.selectById(orderId);
    if (order == null) {
        throw new BusinessException(5001, "订单不存在");
    }
    if (!"created".equals(order.getStatus())) {
        throw new BusinessException(5002, "订单状态不允许取消，当前状态：" + order.getStatus());
    }
    order.setStatus("cancelled");
    orderMapper.updateById(order);
}

统一异常处理，避免暴露堆栈给前端

用 @ControllerAdvice + @ExceptionHandler 拦截自定义异常，返回结构化 JSON（如 {code: 5001, msg: "订单不存在", data: null}），不返回原始异常信息：

防止敏感信息泄露（如数据库字段名、路径）
保持 API 响应格式统一
方便前端根据 code 做差异化提示（如跳转、弹窗、静默重试）

示例：

@RestControllerAdvice
public class GlobalExceptionHandler {

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