如何正确处理findOne抛出的IncorrectResultSizeDataAccessException？

代码背景 #

当前实现的查询方法如下：

public Optional<Student> findStudent(String name, String surname,String nickname)
{
    try {
       return repository.findOne(predicates.hasSpecifications(name, surname,nickname));
    } catch (IncorrectResultSizeDataAccessException e) {
        return Optional.empty();
    }
}

其中findOne方法在匹配多条数据时会抛出IncorrectResultSizeDataAccessException，当前处理逻辑是捕获该异常后返回Optional.empty()，但这种方案存在明显的语义混淆问题。

当前方案的问题 #

• 语义不符：Optional.empty()的核心语义是「未找到任何匹配结果」，而捕获IncorrectResultSizeDataAccessException返回空，相当于把「找到多条结果」的错误场景伪装成「无结果」，完全掩盖了真实问题。
• 调试困难：调用方无法区分是真的没找到数据，还是存在重复数据导致的异常，排查问题时会增加额外成本。
• 业务风险：如果业务逻辑要求条件必须匹配唯一结果，这种处理方式会让重复数据的问题被隐藏，导致业务流程出错却无法及时发现。

可行的解决思路 #

思路1：抛出自定义业务异常，让调用方显式处理 #

定义一个贴合业务场景的自定义异常，将底层的IncorrectResultSizeDataAccessException包装后抛出，保留Optional处理「无结果」的原有逻辑，让调用方可以分别处理两种异常场景：

修改后的方法实现：

public class MultipleStudentsFoundException extends RuntimeException {
    public MultipleStudentsFoundException(String message, Throwable cause) {
        super(message, cause);
    }
}

public Optional<Student> findStudent(String name, String surname,String nickname) {
    try {
        return repository.findOne(predicates.hasSpecifications(name, surname,nickname));
    } catch (IncorrectResultSizeDataAccessException e) {
        throw new MultipleStudentsFoundException("查询到多个匹配的学生，请细化查询条件", e);
    }
}

调用方处理示例：

try {
    Student student = studentService.findStudent(name, surname, nickname)
                                    .orElseThrow(() -> new StudentNotFoundException("未找到匹配的学生"));
    // 处理单结果逻辑
} catch (MultipleStudentsFoundException e) {
    // 处理多条匹配的情况，比如提示用户补充更多查询条件
} catch (StudentNotFoundException e) {
    // 处理无结果的情况
}

思路2：返回自定义结果类型，覆盖三种状态 #

如果不想用异常处理，可以定义一个包含「无结果」「单结果」「多结果」三种状态的自定义返回类型，让调用方通过状态判断来处理不同场景：

自定义结果类型：

public class StudentQueryResult {
    public enum Status { NO_RESULT, SINGLE_RESULT, MULTIPLE_RESULTS }
    
    private final Status status;
    private final Student student;

    // 私有构造方法，通过静态工厂方法创建实例
    private StudentQueryResult(Status status, Student student) {
        this.status = status;
        this.student = student;
    }

    public static StudentQueryResult noResult() {
        return new StudentQueryResult(Status.NO_RESULT, null);
    }

    public static StudentQueryResult singleResult(Student student) {
        return new StudentQueryResult(Status.SINGLE_RESULT, student);
    }

    public static StudentQueryResult multipleResults() {
        return new StudentQueryResult(Status.MULTIPLE_RESULTS, null);
    }

    // Getter方法
    public Status getStatus() { return status; }
    public Student getStudent() { return student; }
}

修改后的方法实现：

public StudentQueryResult findStudent(String name, String surname,String nickname) {
    try {
        Optional<Student> result = repository.findOne(predicates.hasSpecifications(name, surname,nickname));
        return result.map(StudentQueryResult::singleResult)
                     .orElse(StudentQueryResult.noResult());
    } catch (IncorrectResultSizeDataAccessException e) {
        return StudentQueryResult.multipleResults();
    }
}

调用方处理示例：

StudentQueryResult result = studentService.findStudent(name, surname, nickname);
switch (result.getStatus()) {
    case NO_RESULT:
        // 处理无结果逻辑
        break;
    case SINGLE_RESULT:
        Student student = result.getStudent();
        // 处理单结果逻辑
        break;
    case MULTIPLE_RESULTS:
        // 处理多结果逻辑
        break;
}

思路3：提前判断结果数量，避免触发异常 #

如果底层Repository支持统计查询，可以先判断匹配结果的数量，再执行查询，从根源上避免异常抛出：

修改后的方法实现：

public Optional<Student> findStudent(String name, String surname,String nickname) {
    Specification<Student> spec = predicates.hasSpecifications(name, surname,nickname);
    long matchCount = repository.count(spec);
    
    if (matchCount == 0) {
        return Optional.empty();
    } else if (matchCount > 1) {
        throw new MultipleStudentsFoundException("查询到多个匹配的学生，请细化查询条件");
    } else {
        return repository.findOne(spec);
    }
}

注意：这种方式会增加一次数据库查询，对性能有轻微影响，适合数据量较小的场景；也可以优化为查询前2条数据，通过返回结果的数量判断是否超过1条，减少查询开销。

内容的提问来源于stack exchange，提问作者Jsef bch