Hibernate中@OneToOne关联的N+1查询问题解决方法

问题原因 #

默认情况下@OneToOne关联的fetch模式为FetchType.LAZY（懒加载），调用findAll()时会先执行1次查询获取所有Person数据，之后遍历Person对象时（比如序列化JSON的过程中触发address属性的访问），Hibernate会为每个Person单独执行1次Address查询，从而产生N+1查询问题。

解决方案 #

方法一：使用@EntityGraph实现关联抓取（推荐）

在PersonRepository的findAll方法上添加@EntityGraph注解，指定需要关联加载的address属性，Hibernate会自动生成JOIN语句一次性查询所有数据：

@Repository
public interface PersonRepository extends JpaRepository<Person, Long> {
    @EntityGraph(attributePaths = {"address"})
    List<Person> findAll();
}

方法二：自定义JPQL查询

直接编写包含JOIN FETCH的JPQL语句，明确指定关联查询Address：

@Repository
public interface PersonRepository extends JpaRepository<Person, Long> {
    @Query("SELECT p FROM Person p JOIN FETCH p.address")
    List<Person> findAllWithAddress();
}

调用该方法时，Hibernate会生成类似你期望的SELECT * FROM persons INNER JOIN addresses ON persons.address_id = addresses.id的SQL，一次性获取所有Person及对应的Address数据。

方法三：修改关联注解的Fetch模式（谨慎使用）

在Person类的@OneToOne注解中设置fetch = FetchType.EAGER，强制每次加载Person时都关联加载Address：

@OneToOne(cascade = CascadeType.ALL, orphanRemoval = true, fetch = FetchType.EAGER)
@JoinColumn(name = "address_id", referencedColumnName = "id")
private Address address;

注意：此方式为全局生效，所有加载Person的场景都会自动加载Address，若存在不需要Address的场景，会造成不必要的性能开销，因此不推荐作为通用方案。

内容的提问来源于stack exchange，提问作者Andrzej Jankowski