如何在Hibernate中实现用户表与已完成考试表的LEFT JOIN查询

首先咱们先理清你的需求和当前的问题：你想要返回所有用户，如果用户有已完成的考试就带上对应的FinishedExam数据，没有的话该字段为null（这正是LEFT JOIN的预期行为），但你当前调用userRepository.findAll()只返回了未关联考试的用户，这明显是关联配置和查询逻辑出了问题。

问题根源分析 #

你的一对一关联配置里，User类的finishedExam是被动端（inverse side）（通过mappedBy = "user"指定），而FinishedExam是主动端（owning side）。默认情况下，直接调用userRepository.findAll()时，Hibernate的EAGER fetch策略对于被动端关联，不会自动生成LEFT JOIN语句，反而可能因为查询逻辑的问题，只加载了没有关联考试的用户。另外你加的@Fetch(FetchMode.SELECT)会触发N+1查询，也没解决核心的关联加载问题。

可行的解决方案 #

1. 自定义JPQL查询（推荐） #

这是最直接可控的方式，在你的UserRepository中定义一个带LEFT JOIN FETCH的查询方法：

public interface UserRepository extends JpaRepository<User, Long> {
    @Query("SELECT u FROM User u LEFT JOIN FETCH u.finishedExam")
    Iterable<User> findAllWithFinishedExam();
}

然后在控制器中调用这个方法即可：

@GetMapping("/allUsersWithExams")
public Iterable<User> getAllUsersWithTheirExams() {
    return userRepository.findAllWithFinishedExam();
}

这个JPQL会生成标准的LEFT JOIN SQL语句，一次性加载所有用户及其关联的FinishedExam数据（如果存在的话），完美符合你的需求。

2. 调整关联的Fetch模式（不推荐全局使用） #

如果你不想写自定义查询，可以尝试在User类的关联字段上添加@Fetch(FetchMode.JOIN)：

@OneToOne(fetch = FetchType.EAGER, mappedBy = "user")
@Fetch(FetchMode.JOIN)
private FinishedExam finishedExam;

这样Hibernate在执行findAll()时会自动用LEFT JOIN加载关联数据，但这种方式不推荐全局使用——因为EAGER fetch会在所有查询User的场景下都加载关联的FinishedExam，可能在不需要关联数据的场景下造成性能浪费。

3. 确保双向关联的一致性 #

另外要注意，在保存FinishedExam时，一定要维护双向关联的一致性：

// 保存已完成考试的示例代码
User user = userRepository.findById(userId).orElseThrow(() -> new RuntimeException("用户不存在"));
FinishedExam finishedExam = new FinishedExam();
// 设置主动端关联
finishedExam.setUser(user);
// 设置被动端关联，这一步非常关键
user.setFinishedExam(finishedExam);

finishedExamRepository.save(finishedExam);
userRepository.save(user);

如果只设置了finishedExam.setUser(user)而没有同步设置user.setFinishedExam(finishedExam)，Hibernate的持久化上下文可能无法正确识别关联关系，导致查询时数据不匹配。

额外澄清：如果需求是只返回有考试的用户 #

如果你之前的表述有误，实际需求是只返回存在已完成考试的用户（也就是INNER JOIN），只需要把JPQL改成：

@Query("SELECT u FROM User u INNER JOIN FETCH u.finishedExam")
Iterable<User> findAllWithExistingFinishedExam();

这样就只会返回那些关联了FinishedExam的用户。

内容的提问来源于stack exchange，提问作者Sinan Samet