在Java中如何捕获异常并封装为业务异常返回

在Java开发中，通常需要将底层异常（如SQLException、IOException等）转换为自定义的业务异常，以便上层统一处理并避免暴露技术细节。以下是实现异常捕获与封装的关键步骤和示例。

定义业务异常类

创建一个继承自RuntimeException的自定义异常类，便于抛出且不需要强制捕获。

示例：

public class BusinessException extends RuntimeException {
    private String errorCode;

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

    public BusinessException(String message, Throwable cause) {
        super(message, cause);
    }

    // getter方法
    public String getErrorCode() {
        return errorCode;
    }
}

立即学习“Java免费学习笔记（深入）”；

捕获系统异常并封装为业务异常

在服务层或数据访问层中，使用try-catch捕获底层异常，并将其封装成业务异常抛出。

示例：

public void updateUser(User user) {
    try {
        // 可能抛出SQLException或其它异常
        userDao.update(user);
    } catch (SQLException e) {
        throw new BusinessException("UPDATE_USER_FAILED", "用户更新失败")；
    } catch (IOException e) {
        throw new BusinessException("IO_ERROR", "文件处理异常");
    }
}

千面视频动捕

千面视频动捕是一个AI视频动捕解决方案，专注于将视频中的人体关节二维信息转化为三维模型动作。

27

查看详情

保留原始异常信息

封装时建议保留原始异常作为cause，有助于排查问题。

改进写法：

catch (SQLException e) {
    throw new BusinessException("UPDATE_USER_FAILED", "用户更新失败: " + e.getMessage(), e);
}

这样在日志中可以打印完整堆栈，同时对外返回的是清晰的业务错误码。

结合AOP或全局异常处理器统一处理

对于重复的封装逻辑，可配合Spring的@ControllerAdvice或AOP进行统一拦截，减少代码冗余。

也可以在控制器层面统一捕获BusinessException，返回标准格式的响应结果。

基本上就这些。关键是通过自定义异常类明确表达业务含义，同时隐藏底层细节，提升系统的可维护性和用户体验。