Hibernate原生查询关联表仍出现N+1问题 如何实现单查询结果映射

问题根因 #

你当前遇到的N+1问题不是@OneToMany/@ManyToOne注解本身导致的，是你写的原生SQL查询没有告知JPA需要同步加载关联的List<B>集合：默认原生查询只会填充A实体的基本字段，List<B>仍然是懒加载代理对象，后续你访问这个集合时，Hibernate就会针对每个A实例触发一次单独查询，也就是你看到的N+1现象。
你移除关联注解后IDEA报错是必然的：JPA默认会将没有标注关联注解的字段识别为@Basic类型（对应数据库单个列的基本数据类型），不支持容器类型作为@Basic属性。

解决方案 #

方案1：使用JPQL fetch join（最便捷，优先推荐） #

不需要修改现有实体注解，直接将你的自定义查询改为JPQL的fetch join写法，就能实现单次查询加载A和所有关联的B：

// 注意a.bList替换为你A实体中List<B>对应的字段名
@Query("select distinct a from A a left join fetch a.bList")
List<A> findAllWithB();

加distinct是为了避免左连接后A实例重复的问题。

方案2：使用实体图@EntityGraph（无需写查询语句） #

如果你不想手写JPQL，可以用JPA提供的实体图功能实现关联预加载：

1. 在A实体上添加实体图定义：

@Entity
@NamedEntityGraph(
    name = "A.fetchB",
    attributeNodes = @NamedAttributeNode("bList")
)
public class A {
    // 原有字段和注解保持不变
    @OneToMany(mappedBy = "a")
    private List<B> bList;
}

2. 在Repository方法上标注实体图：

@EntityGraph(value = "A.fetchB", type = EntityGraph.EntityGraphType.FETCH)
List<A> findAll();

调用该findAll方法时就会自动生成左连接查询，一次性加载所有关联B，不会触发N+1。

方案3：坚持用原生SQL的处理方式 #

如果业务要求必须使用原生SQL，你需要额外配置结果集映射来关联填充A的List<B>集合，参考写法：

1. 在A实体上添加原生查询和结果映射配置：

@Entity
@NamedNativeQuery(
    name = "A.findAllWithBNative",
    query = "select a.*, b.* from A as a left join B as b on a.ID = b.a_id",
    resultSetMapping = "AWithBMapping"
)
@SqlResultSetMapping(
    name = "AWithBMapping",
    entities = {
        @EntityResult(entityClass = A.class),
        @EntityResult(entityClass = B.class)
    }
)
public class A {
    // 原有内容保持不变
}

2. Repository中声明对应方法：

@Query(nativeQuery = true, name = "A.findAllWithBNative")
List<A> findAllWithBNative();

关于是否放弃Hibernate/JPA #

完全不需要，你遇到的只是JPA关联加载的常规用法问题，JPA本身提供了非常成熟的N+1问题解决方案，远不需要到换框架的程度。

注意：如果需要做分页查询，不要直接对fetch join的结果做分页，会触发内存分页，正确做法是先分页查询A的ID列表，再用ID列表关联查询所有B，最后在内存中组装A和B的关联关系。

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