自定义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; }
}
在业务逻辑中抛出业务异常
当检测到不符合业务规则的情况时，主动抛出自定义异常，避免使用系统异常表达业务含义。
立即学习“Java免费学习笔记（深入）”；
例如：
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全局捕获，实现统一异常处理。
建议的最佳实践
- 为业务异常设置明确的错误码，便于排查和国际化支持
- 避免将技术细节暴露给用户，异常信息应简洁友好
- 不要用异常控制正常流程，仅用于异常情况
- 在日志中记录必要的上下文信息，如用户ID、操作类型等
- 考虑集成到统一的错误响应结构中，提升API一致性
