Hibernate Criteria 6嵌套对象投影异常：SQL相同结果数不同

实体模型 #

@Entity
public class MyAuthor {
    private String id;
    private String name;
    private int nbBooks;
    private Date birthDate;
    @Embedded
    private MyAddress address;
}

@Embeddable
public class MyAddress {
    private String street;
    private MyCity city;
}

@Entity
public class MyCity {
   String id;
   String name;
}

单元测试代码 #

// 前置操作：初始化数据，包含CITY_1、CITY_2，ADDR_1关联CITY_1，ADDR_2关联CITY_1，ADDR_3关联CITY_2

CriteriaBuilder criteriaBuilder = sessionFactory.getCurrentSession().getCriteriaBuilder();
CriteriaQuery<MyCity> query = criteriaBuilder.createQuery(MyCity.class);
Root<MyAuthor> root = query.from(MyAuthor.class);
Join<MyAuthor, MyAddress> from = root.join("address", JoinType.LEFT);

// 生成SQL：select c1_0.id,c1_0.name from MyAuthor ma1_0 left join MyCity c1_0 on c1_0.id=ma1_0.city_id where c1_0.name is not null
query.select(from.get("city"))
    .where(criteriaBuilder.isNotNull(from.get("city").get("name")));
    
// 生成相同SQL：select c1_0.id,c1_0.name from MyAuthor ma1_0 left join MyCity c1_0 on c1_0.id=ma1_0.city_id where c1_0.name is not null
// query.multiselect(from.get("city").get("id"), from.get("city").get("name"))
// .where(criteriaBuilder.isNotNull(from.get("city").get("name")));


// 使用query.select()得到2条结果，使用query.multiselect()得到3条结果
List<MyCity> cities = sessionFactory.getCurrentSession().createQuery(query).getResultList();

assertEquals(3, cities.size());

原因分析 #

1. 两种查询方式的对象处理逻辑不同 #

• select方式：当指定select(from.get("city"))时，Hibernate明确知晓要返回MyCity实体对象，此时会开启实体去重机制——它会依据实体主键（id）判断结果是否重复，即便SQL返回多条相同主键的记录，Hibernate也只会保留一个唯一的实体实例，最终得到2条结果（对应CITY_1和CITY_2两个唯一城市）。
• multiselect方式：multiselect本质是投影查询，即便声明了CriteriaQuery<MyCity>，Hibernate也会先将SQL返回的每行数据封装为Object[]数组，再尝试映射为MyCity实例。这个过程不会触发实体去重，SQL返回的3条原始记录（两个关联CITY_1的Author、一个关联CITY_2的Author）会被分别转换成3个MyCity实例，其中两个实例的id均为CITY_1的ID，但属于不同对象。

2. SQL结果与对象映射的差异 #

你的SQL确实会返回3条记录，但select方式下Hibernate会对实体实例去重，而multiselect方式直接返回所有映射后的实例，这就是结果数量不同的核心原因。

内容的提问来源于stack exchange，提问作者Rémi C.