Hibernate JPA多对多Eager Loading失效问题求助

以下是针对该问题的排查方向和解决方案：

1. 检查实体类关联配置 #

确保User和Subscription的@ManyToMany注解配置完全匹配数据库结构：

• 维护端（无mappedBy的一方）需正确指定中间表、关联外键：

  // User类（维护端）
  @ManyToMany(fetch = FetchType.EAGER)
  @JoinTable(
      name = "user_subscriptions",
      joinColumns = @JoinColumn(name = "user_id"), // 对应用户表外键
      inverseJoinColumns = @JoinColumn(name = "subscription_id") // 对应订阅表外键
  )
  private Set<Subscription> subscriptions = new HashSet<>();
  

• 被维护端需通过mappedBy指向维护端的关联字段：

  // Subscription类（被维护端）
  @ManyToMany(mappedBy = "subscriptions", fetch = FetchType.LAZY)
  private Set<User> users = new HashSet<>();
  

注意：保存关联数据时，需确保维护端的集合已正确赋值并持久化。

2. 确保查询在事务上下文内执行 #

JPA的EAGER加载依赖打开的EntityManager，如果查询不在事务中执行，EntityManager可能提前关闭，导致关联集合无法加载。

• 在调用findById的Service方法或类上添加@Transactional注解，让查询在事务上下文内完成：

  @Service
  @Transactional
  public class UserService {
      private final UserRepository userRepository;
  
      public UserService(UserRepository userRepository) {
          this.userRepository = userRepository;
      }
  
      public Optional<User> getUserById(Long id) {
          return userRepository.findById(id);
      }
  }
  

3. 修正实体类的equals/hashCode实现 #

如果User或Subscription的equals/hashCode方法依赖关联集合或可变字段，会导致JPA无法正确识别实体，进而无法加载关联数据。

• 基于实体的唯一标识（如id字段）实现这两个方法：

  // User类示例
  @Override
  public boolean equals(Object o) {
      if (this == o) return true;
      if (o == null || getClass() != o.getClass()) return false;
      User user = (User) o;
      return Objects.equals(id, user.id);
  }
  
  @Override
  public int hashCode() {
      return Objects.hash(id);
  }
  

4. 排查缓存问题 #

一级缓存（EntityManager缓存）或二级缓存可能返回未加载关联数据的旧实体：

• 若使用EntityManager，可调用entityManager.refresh(user)强制从数据库刷新实体及关联数据；
• 若开启了二级缓存，可暂时关闭缓存测试，或检查缓存配置是否正确关联了关联集合的加载策略。

5. 使用显式关联查询（兜底方案） #

即使配置了FetchType.EAGER，部分场景下仍需显式指定关联加载。可在UserRepository中定义自定义查询：

public interface UserRepository extends JpaRepository<User, Long> {
    @Query("SELECT u FROM User u JOIN FETCH u.subscriptions WHERE u.id = :id")
    Optional<User> findByIdWithSubscriptions(@Param("id") Long id);
}

内容的提问来源于stack exchange，提问作者Issatay Tleuov