HQL语句适配Persistence Query，却无法在Hibernate @Formula中正常执行

嘿，你遇到的这个坑其实挺常见的——Hibernate的@Formula注解根本不支持HQL语句，它只接受原生SQL（Native SQL）！这就是为什么你的查询在Persistence Query里能正常跑，但放到@Formula里就炸锅的原因。

为什么会报错？ #

你写的@Formula内容是标准的HQL：用实体类名（EntityA、EntityB）、实体属性名（entityA.id、entityB.companyId）来构建查询，但@Formula的设计是直接生成数据库能执行的SQL，它不会经过Hibernate的HQL解析器。所以数据库根本看不懂这些实体类和属性的名字，自然就抛出异常了。

怎么修复？ #

你需要把HQL转换成对应的原生SQL，调整几个关键点：

1. 把实体类名换成数据库表名：比如EntityA换成实际的表名（比如entity_a，取决于你的表命名规则）
2. 把实体属性名换成数据库字段名：比如entityB.listValueId换成entity_b.list_value_id（通常是下划线命名）
3. 确保SQL本身能独立执行：先在数据库客户端里把SQL跑通，再放到@Formula里

举个修改后的例子（假设你的表和字段是下划线命名）：

@Formula(value = "(SELECT string_agg(entity_a.id, ',') FROM entity_a " +
        "INNER JOIN list_value ON entity_a.id = list_value.id " +
        "WHERE list_value.id IN (" +
        "    SELECT entity_b.list_value_id FROM entity_b " +
        "    WHERE entity_b.company_id IN (" +
        "        SELECT entity_c.id FROM entity_c " +
        "        WHERE entity_c.id = '162B7E74-713C-4565-AAD2-52EC57B07419'" +
        "    )" +
        "))")
// 注意：string_agg是PostgreSQL的字符串聚合函数，MySQL用GROUP_CONCAT，Oracle用LISTAGG，根据你的数据库调整

额外提醒：映射集合别用@Formula！ #

哦对了，你要映射的是Set<EntityA>这种集合类型，@Formula其实不是最佳选择——它主要用来映射单个标量值（比如数字、字符串）或者嵌入式对象。如果要映射集合，更推荐用@OneToMany结合@JoinFormula来定义关联关系，示例如下：

@OneToMany
@JoinFormula(
    value = "(SELECT list_value.id FROM list_value " +
            "INNER JOIN entity_b ON list_value.id = entity_b.list_value_id " +
            "INNER JOIN entity_c ON entity_b.company_id = entity_c.id " +
            "WHERE entity_c.id = '162B7E74-713C-4565-AAD2-52EC57B07419')",
    referencedColumnName = "id"
)
private Set<EntityA> entityASet;

这种方式更符合Hibernate的关联映射规范，也能避免@Formula带来的一些限制。

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