Java 中怎么在 Mapper 层抛出自定义数据异常-java教程-PHP中文网

mapper层不建议直接抛业务异常，应由service层调用mapper前后检查结果并抛出自定义异常，如查询为空时throw userdatanotfoundexception，配合@controlleradvice统一处理。

java 中怎么在 mapper 层抛出自定义数据异常

在 Java 的 MyBatis（或 MyBatis-Plus）项目中，Mapper 层本身不建议直接抛出业务异常（包括自定义数据异常），因为 Mapper 接口是 MyBatis 生成代理对象的契约，其方法默认只声明 throws RuntimeException（运行时异常），且底层 SQL 执行失败会自动包装为 org.apache.ibatis.exceptions.PersistenceException 等运行时异常。

但你确实可以「在 Mapper 层语义上」实现对数据异常的识别与主动抛出——关键在于：把校验和异常抛出逻辑放在 Service 层调用 Mapper 前后，或借助 Mapper 方法返回结果后的判断 + 显式 throw。下面分几种常用、合理的方式说明：

✅ 方式一：Service 层调用 Mapper 后检查结果并抛出自定义异常

这是最推荐、最清晰的做法。Mapper 只负责查/改/删，不处理业务逻辑；Service 拿到结果后判断是否符合业务预期，再决定是否抛异常。

例如查询用户，但数据库没查到：

// UserMapper.java
User selectById(Long id);

// UserService.java
public User getUserById(Long id) {
    User user = userMapper.selectById(id);
    if (user == null) {
        throw new UserDataNotFoundException("用户不存在，id=" + id);
    }
    return user;
}

优点：职责分离明确，异常语义清晰，便于统一异常处理（如 @ControllerAdvice）
注意：不要在 Mapper 接口方法上声明 throws UserDataNotFoundException（编译会报错，因 MyBatis 代理不支持受检异常）

✅ 方式二：用 Optional 包装返回值（语义增强，仍需 Service 判空）

虽不能改变 Mapper 的异常机制，但可提升可读性：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

// Mapper 接口保持不变（MyBatis 不支持 Optional 作为返回类型直接映射）
// ✅ 正确做法：在 Service 中封装
public Optional<user> findUserOptById(Long id) {
    return Optional.ofNullable(userMapper.selectById(id));
}
</user>

后续使用：findUserOptById(100L).orElseThrow(() -> new UserDataNotFoundException("用户未找到"));

✅ 方式三：在 XML 或注解 SQL 中用 `<if></if>` / `@SelectProvider` 做前置校验（不推荐用于异常抛出）

SQL 层适合做数据过滤，不适合抛 Java 异常。MyBatis 无法在 SQL 执行过程中 throw 自定义异常。你可以用 <where></where> 动态拼条件，但“抛异常”必须交由 Java 层完成。

错误示例（语法不通，MyBatis 不解析 Java throw）：

<!-- ❌ 无效！MyBatis XML 不支持 Java throw 语句 -->
<if test="id == null">throw new UserDataException("id 不能为空");</if>

✅ 补充：全局异常统一处理（让自定义异常生效）

定义好异常后，配合 Spring 的 @ControllerAdvice 统一捕获，返回友好 JSON：

@ResponseStatus(HttpStatus.NOT_FOUND)
public class UserDataNotFoundException extends RuntimeException {
    public UserDataNotFoundException(String msg) {
        super(msg);
    }
}
<p>// 全局处理器
@ControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(UserDataNotFoundException.class)
@ResponseBody
public Result> handleUserDataNotFound(UserDataNotFoundException e) {
return Result.fail(404, e.getMessage());
}
}
</p>

不复杂但容易忽略：Mapper 是数据访问契约，不是业务入口。所有数据合法性判断、空值处理、异常语义包装，都应该落在 Service 层 —— 这样既符合分层规范，又利于测试、复用和维护。