Hibernate DTO投影N+1查询问题：两种构造方式为何执行次数不同

问题背景 #

使用Hibernate时发现两种DTO构造查询的SQL执行次数存在明显差异：

实体与DTO定义 #

@Getter
@Setter
public class ClassDto {
     private String id;
     private String name;

      public ClassDto(Entity e) {
         this.id = e.id;
        this.name = e.name;
      }

      public ClassDto(String id, String name) {
          this.id = id;
          this.name = name;
      }
}

@Entity
@Setter
@Getter
public class Entity {
     @Id String id;
     String name;
}

查询差异 #

• 触发N+1次SQL的查询：

  select new org.xyz.ClassDto(e) from Entity e
  

  当表中有3条数据时，输出如下：

  Hibernate: select entitya0_.id as col_0_0_ from test.entitya entitya0_
  Hibernate: select entitya0_.id as id1_0_0_, entitya0_.first_name as first_na2_0_0_, entitya0_.last_name as last_nam3_0_0_ from test.entitya entitya0_ where entitya0_.id=?
  Hibernate: select entitya0_.id as id1_0_0_, entitya0_.first_name as first_na2_0_0_, entitya0_.last_name as last_nam3_0_0_ from test.entitya entitya0_ where entitya0_.id=?
  Hibernate: select entitya0_.id as id1_0_0_, entitya0_.first_name as first_na2_0_0_, entitya0_.last_name as last_nam3_0_0_ from test.entitya entitya0_ where entitya0_.id=?
  

• 仅执行1次SQL的查询：

  select new org.xyz.ClassDto(e.id, e.name) from Entity e
  

  对应输出：

  Hibernate: select entitya0_.id as col_0_0_, entitya0_.first_name as col_1_0_, entitya0_.last_name as col_2_0_ from test.entitya entitya0_
  

底层逻辑解释 #

1. 传入实体对象的构造查询（new ClassDto(e)） #

Hibernate对这种HQL的处理流程是：

• 第一步：仅查询实体的主键字段，得到所有匹配数据的主键列表（对应1条SQL）。
• 第二步：遍历主键列表，逐个触发实体加载逻辑（类似EntityManager.find()），获取完整的实体对象（对应N条SQL，N为数据条数）。
• 第三步：用加载后的完整实体作为参数，调用DTO的构造方法生成实例。

核心原因是：HQL中直接传入实体变量e时，框架会判定需要先获取完整的实体实例，而非直接提取属性。即使DTO只用到部分属性，Hibernate也会先加载整个实体，最终导致N+1查询问题。

2. 传入实体属性的构造查询（new ClassDto(e.id, e.name)） #

这种情况下Hibernate的处理逻辑更直接：

• 解析HQL中指定的属性，生成一条SQL一次性查询所有需要的字段（id、name等）。
• 用查询返回的字段值直接调用DTO的多参构造方法，无需加载完整实体对象。

因为HQL明确指定了要提取的属性，框架可以直接将这些属性映射到DTO的构造参数，跳过实体加载步骤，因此仅执行1次SQL。

总结 #

两种构造方式的核心差异在于：

• 传入实体对象时，Hibernate需要先加载完整实体实例，触发N+1查询。
• 传入属性时，Hibernate直接查询所需字段，避免加载实体，仅执行1次SQL。

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