问题分析:@ElementCollection与@Formula组合抛出"not an entity"异常的原因
核心原因 @ElementCollection和@Formula的组合用法违背了Hibernate的设计逻辑,两者的定位和适用场景不兼容:
单个字段的@Formula能正常运行的原因 :
当@Formula映射单个简单类型(比如String)时,Hibernate会将子查询返回的单列单行结果 直接绑定到实体字段,这是@Formula的标准使用场景——它本质是为实体字段提供一个计算/查询出来的单个值。
配置一(List)的问题 :
@ElementCollection的设计初衷是映射基本类型集合 或嵌入类集合 ,通常需要配合@CollectionTable指定存储集合的表,或者关联到实体的@OneToMany关系。你试图用@Formula的子查询返回单列集合来填充List,但Hibernate不会把@Formula的子查询结果解析为集合的数据源,反而会默认认为你要映射一个实体集合,但找不到对应的实体类,因此抛出"not an entity"异常。
配置二(List)的问题:
这个配置的问题更突出:子查询返回了两列(name和locale),但List无法匹配多列结果的结构;同时和配置一一样,@ElementCollection不支持通过@Formula的多列子查询来构建集合,Hibernate既无法解析多列到Object的映射,也找不到对应的实体/集合表,最终触发相同异常。
可行的替代方案 获取单列集合 :
如果需要从translations表中查询单个字段的集合,可以使用@OneToMany关联到Translations实体,或者用@ElementCollection配合@CollectionTable(如果有单独的集合表)。如果必须用子查询方式,可以使用@Subselect来映射虚拟集合表:
@ElementCollection
@Subselect("select concat_ws(' ', name, locale) as data from translations where id = internalId")
@Column(name = "data")
private List<String> data;
获取多列集合 :
定义一个@Embeddable类封装name和locale,再用@ElementCollection配合@Subselect映射:
@Embeddable
public class TranslationData {
private String name;
private String locale;
// 构造器、getter/setter
}
// 实体中使用
@ElementCollection
@Subselect("select name, locale from translations where id = internalId")
@AttributeOverrides({
@AttributeOverride(name = "name", column = @Column(name = "name")),
@AttributeOverride(name = "locale", column = @Column(name = "locale"))
})
private List<TranslationData> data;
内容的提问来源于stack exchange,提问作者rakeeee