Quarkus+Hibernate Panache非表关联实体NamedQuery类转换异常问题

问题原因 #

1. LoginDetails 类的注解使用错误
   @Entity 注解只能用于映射数据库真实存在的表的实体类，你创建的 LoginDetails 是用来接收查询结果的DTO（数据传输对象），不属于映射实体，Hibernate不会自动将关联查询的结果封装为该类的实例。你写的HQL默认返回三个关联实体组成的Object[]数组，Java泛型擦除机制会让编译阶段不报错，运行时遍历才会抛出ClassCastException。
2. HQL 关联逻辑错误
   原生SQL的关联逻辑是table_a JOIN table_b JOIN table_c，你写的HQL中JOIN TableA b是明显错误，关联的实体类和关联条件都不符合你的表结构。

解决方案 #

不需要切回原生查询，Hibernate/Panache提供了成熟的DTO结果封装方案，你可以选择以下任意一种：

方案1：使用HQL构造器表达式（SELECT NEW） #

第一步：改造LoginDetails为普通POJO，删除所有JPA实体相关注解，添加全参数构造方法：

// 不要加任何@Entity、@Id相关注解
public class LoginDetails {
    private int id;
    private String name;
    private String loginDate;

    // 必须加和查询字段顺序、类型匹配的全参数构造方法
    public LoginDetails(int id, String name, String loginDate) {
        this.id = id;
        this.name = name;
        this.loginDate = loginDate;
    }
    // 按需添加getter、setter
}

第二步：调整HQL，使用SELECT NEW指定要封装的DTO类，同时修正关联逻辑：

SELECT NEW 你的LoginDetails类完整包名.LoginDetails(a.id, a.name, c.loginDate)
FROM TableA a 
JOIN TableB b ON b.aId = a.id 
JOIN TableC c ON b.cId = c.id 
WHERE c.loginDate > :fromDate

第三步：调整查询方法直接返回对应列表即可。

方案2：使用Panache接口投影 #

如果不想写构造方法，可以直接定义投影接口：

public interface LoginDetailsProjection {
    int getId();
    String getName();
    String getLoginDate();
}

查询时直接指定返回类型为该接口，Panache会自动生成代理类封装结果：

public static List<LoginDetailsProjection> findFromDate(String fromDate) {
    return find("SELECT a.id as id, a.name as name, c.loginDate as loginDate " +
            "FROM TableA a JOIN TableB b ON b.aId = a.id JOIN TableC c ON b.cId = c.id " +
            "WHERE c.loginDate > ?1", fromDate).list();
}

额外优化建议 #

建议先给三个映射实体配置好关联关系注解（@ManyToOne/@OneToMany），之后写HQL时不需要手动写ON关联条件，直接通过属性关联即可，写法更简洁也不容易出错。

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