java 中通过捕获底层异常并包装为自定义业务异常来实现接口统一,核心做法是在服务层使用 try-catch 块拦截具体异常,利用构造器传入原始异常作为 cause,从而对外暴露一致的异常类型。这样做能让调用方无需关心内部实现细节,只需处理顶层的业务异常即可获取错误信息或堆栈追踪。若未指定新的错误码或消息,转换后的异常将保留原始异常的上下文,便于后续排查。

如何定义统一的业务异常类
定义一个继承自 RuntimeException 的基类,提供标准构造函数以支持链式异常传递。该类应包含错误码和错误消息字段,确保所有上层模块抛出异常时都遵循同一契约。子类可以扩展特定场景的错误码,但必须保持父类的结构一致性,以便统一拦截和处理。

public class BusinessException extends RuntimeException {
private final String errorCode;
public BusinessException(String errorCode, String message, Throwable cause) {
super(message, cause);
this.errorCode = errorCode;
}
public BusinessException(String errorCode, String message) {
super(message);
this.errorCode = errorCode;
}
public String getErrorCode() {
return errorCode;
}
}如何在 Service 层进行异常转换
在 Service 方法中捕获具体的运行时异常(如 NullPointerException 或 IllegalArgumentException),并将其转换为 BusinessException。转换时需映射具体的错误码,例如将参数校验失败映射为 "INVALID_PARAM"。这样 Controller 层只需捕获 BusinessException 即可返回统一的 JSON 错误响应,屏蔽了内部实现的复杂性。
Biome 是一个基于 Rust 的高性能工具链,适用于 JavaScript、TypeScript、JSX、JSON、CSS 和 GraphQL,它将格式化和 linting 统一到一个工具中。具有 97% 的 Prettier 兼容性以及超过 450 条 lint 规则,Biome 以显著更快的执行速度取代了 ESLint 和 Prettier。
立即学习“Java免费学习笔记(深入)”;

@Service
public class UserService {
public User getUserById(Long id) {
try {
if (id == null) {
throw new IllegalArgumentException("ID cannot be null");
}
// 模拟数据库查询
return new User(id, "John");
} catch (IllegalArgumentException e) {
throw new BusinessException("INVALID_PARAM", "Invalid user ID", e);
} catch (Exception e) {
throw new BusinessException("SYSTEM_ERROR", "Internal server error", e);
}
}
}全局异常处理器如何统一响应格式
使用 @RestControllerAdvice 和 @ExceptionHandler 注解在全局层面捕获 BusinessException。处理器提取错误码和消息,封装为标准的 ApiResponse 对象返回给客户端。这种机制确保了无论 Service 层抛出何种业务异常,HTTP 响应结构始终保持一致,简化了前端或调用方的错误处理逻辑。

















