在java异常处理中,业务异常和系统异常的区分核心在于是否由用户操作或特定业务规则触发。业务异常(如参数校验失败、库存不足)通常继承自`runtimeexception`,代表程序逻辑上的预期内错误,调用方应捕获并给出友好提示;系统异常(如数据库宕机、空指针)则代表基础设施或代码缺陷导致的非预期错误,通常不应被业务层吞没,而应交由全局异常处理器统一记录日志并返回通用错误码。

如何定义业务异常的基类
业务异常需要能够携带具体的业务错误码和消息,以便前端或调用方能精准识别。我们定义一个名为`BusinessException`的类,它继承自`RuntimeException`,这样既保证了非受检特性,又允许在构造时传入自定义的错误码。

public class BusinessException extends RuntimeException {
private final String errorCode;
public BusinessException(String errorCode, String message) {
super(message);
this.errorCode = errorCode;
}
public String getErrorCode() {
return errorCode;
}
}
在Service层使用时,直接抛出该异常即可:
if (user == null) {
throw new BusinessException("USER_NOT_FOUND", "用户不存在");
}
预期结果:Controller层捕获到`BusinessException`后,提取`errorCode`和`message`,封装成统一的JSON响应返回给客户端,例如`{"code":"USER_NOT_FOUND","msg":"用户不存在"}`。
如何处理系统异常与全局兜底
系统异常包括`NullPointerException`、`SQLException`等,它们通常没有明确的业务含义,而是代表环境故障或编程错误。为了统一处理这些异常,我们使用Spring的`@RestControllerAdvice`来定义全局异常处理器。它将拦截所有未被处理的异常,并根据类型返回标准化的错误结构。
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。

@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(BusinessException.class)
public ResponseEntity<result> handleBusinessException(BusinessException e) {
Result result = new Result();
result.setCode(e.getErrorCode());
result.setMsg(e.getMessage());
return ResponseEntity.ok(result);
}
@ExceptionHandler(Exception.class)
public ResponseEntity<result> handleSystemException(Exception e) {
// 记录系统日志
log.error("System error", e);
Result result = new Result();
result.setCode("SYSTEM_ERROR");
result.setMsg("系统内部错误,请联系管理员");
return ResponseEntity.status(500).body(result);
}
}</result></result>
预期结果:当发生`ArithmeticException`或`NullPointerException`时,全局处理器会捕获它,记录堆栈日志,并返回HTTP 500状态码及通用错误信息,避免将底层细节暴露给前端。
当业务异常嵌套在系统异常中时如何处理
在某些复杂场景下,底层调用可能抛出系统异常,但其根本原因是业务逻辑问题。例如,调用第三方支付接口时因网络超时抛出`SocketTimeoutException`,但重试机制耗尽后应视为业务失败。此时需要在Service层进行转换。
try {
paymentGateway.charge(amount);
} catch (PaymentException e) {
if (e.isRetryExhausted()) {
throw new BusinessException("PAY_TIMEOUT", "支付超时,请检查账户余额");
}
throw e;
}
预期结果:通过这种包装,原本的系统级超时异常被转换为明确的业务异常`PAY_TIMEOUT`,全局处理器会将其作为业务异常处理,返回200状态码和具体业务提示,而不是500错误,从而提升用户体验。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










