如何在Java中捕获并处理业务流程异常

P粉602998670 2025-10-21 00:00:00 次阅读

自定义BusinessException类区分业务与系统异常，通过try-catch或@ControllerAdvice捕获处理，抛出时携带错误码与友好信息，确保程序健壮性与API一致性。

在Java中捕获并处理业务流程异常，关键在于区分系统异常与业务异常，并通过合理的异常设计和处理机制保障程序的健壮性和可维护性。核心做法是自定义业务异常类，结合try-catch块进行捕获，并在适当层级统一处理或反馈给调用方。

定义业务异常类

业务异常通常表示流程中的预期问题，比如参数校验失败、余额不足、用户未登录等。这类异常应继承RuntimeException或Exception，便于抛出和捕获。

示例：

public class BusinessException extends RuntimeException {
    private String code;

    public BusinessException(String message) {
        super(message);
    }

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

    // getter方法
    public String getCode() { return code; }
}

在业务逻辑中抛出业务异常

当检测到不符合业务规则的情况时，主动抛出自定义异常，避免使用系统异常表达业务含义。

例如：

public void transferMoney(String fromAccount, String toAccount, BigDecimal amount) {
    if (amount.compareTo(BigDecimal.ZERO)         throw new BusinessException("INVALID_AMOUNT", "转账金额必须大于零");
    }

    if (!accountExists(fromAccount)) {
        throw new BusinessException("ACCOUNT_NOT_FOUND", "转出账户不存在");
    }

    // 其他逻辑...
}

捕获并处理业务异常

在服务调用层或控制器中使用try-catch捕获业务异常，做日志记录、封装响应或提示信息。

常见场景如下：

try {
    service.transferMoney("A123", "B456", new BigDecimal("100.00"));
} catch (BusinessException e) {
    log.warn("业务异常：{}", e.getMessage());
    // 返回友好的错误信息给前端
    response.setCode(e.getCode());
    response.setMessage(e.getMessage());
}

在Spring MVC中，也可通过@ControllerAdvice全局捕获，实现统一异常处理。