JPA Criteria查询multiselect子查询返回实体实例化失败问题

问题场景 #

Spring应用使用Criteria Query的multiselect查询数据，返回包含两个完整Address实体子查询结果的DataResultQuery DTO。原开发环境运行正常，更新依赖库后执行报错：

Cannot instantiate class 'com.package.example.result_queries.DataResultQuery' (it has no constructor with signature

已手动添加全参构造器，但问题仍未解决。

问题根源 #

依赖更新后（比如Hibernate从5.x升级到6.x），JPA实现对multiselect的参数处理逻辑变得更严格：当你直接在multiselect中传入完整实体（子查询返回的Address）时，JPA会将实体拆解为单个字段值传递，而非作为一个整体对象，导致无法匹配DataResultQuery的全参构造器（构造器期望接收Address对象，实际收到的是多个字符串/数值字段）。

解决方案 #

1. 使用CriteriaBuilder.construct()明确指定DTO构造器 #

替换原有的multiselect为construct方法，强制JPA将每个子查询结果作为完整对象传递给DTO构造器：

public DataResultQuery getData(Long id) {
    var builder = entityManager.getCriteriaBuilder();
    var query = builder.createQuery(DataResultQuery.class);

    var user = query.from(User.class);
    var addressJoin = user.join(User_.addresses);

    var firstAddress = getSubquery(addressJoin);
    var lastAddress = getSubquery(addressJoin);

    // 用construct替代multiselect，明确指定DTO构造器
    query.select(builder.construct(DataResultQuery.class,
            user.get(User_.name),
            user.get(User_.lastName),
            firstAddress,
            lastAddress
    ));

    // 添加你的查询条件
    query.where(builder.equal(user.get(User_.id), id));

    var typedQuery = entityManager.createQuery(query);
    return typedQuery.getSingleResult();
}

2. 修正子查询中的变量冲突 #

原getSubquery方法存在变量名重复问题（参数address与方法内的address变量重名），修正后避免编译/逻辑错误：

private Subquery<Address> getSubquery(Join<?, Address> addressJoin) {
    var builder = entityManager.getCriteriaBuilder();
    var subquery = entityManager.createCriteriaQuery(Address.class).subquery(Address.class);
    var subAddress = subquery.from(Address.class);

    subquery.select(subAddress);
    // 添加子查询的过滤条件，例如关联到当前用户
    // subquery.where(builder.equal(subAddress.get(Address_.userId), addressJoin.get(Address_.userId)));

    return subquery;
}

3. 确保DTO构造器的正确性 #

虽然使用了@AllArgsConstructor，但建议手动显式定义全参构造器，避免Lombok版本更新导致的构造器生成异常，确保参数顺序与construct方法的参数顺序完全匹配：

public class DataResultQuery {
    private String name;
    private String lastName;
    private Address firstAddress;
    private Address lastAddress;

    // 显式定义全参构造器
    public DataResultQuery(String name, String lastName, Address firstAddress, Address lastAddress) {
        this.name = name;
        this.lastName = lastName;
        this.firstAddress = firstAddress;
        this.lastAddress = lastAddress;
    }

    // Getter方法
    public String getName() { return name; }
    public String getLastName() { return lastName; }
    public Address getFirstAddress() { return firstAddress; }
    public Address getLastAddress() { return lastAddress; }
}

关键说明 #

依赖更新后，JPA对构造器匹配的校验逻辑更严格，必须确保：

• 构造器参数类型与construct方法传入的参数类型完全一致
• 实体子查询必须返回完整的实体对象，而非部分字段
• 避免使用multiselect直接传递实体，改用construct明确指定构造器

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