迁移Hibernate XML到注解时泛型属性映射异常的解决方法

你遇到的这个org.hibernate.AnnotationException异常，核心是Hibernate没办法识别你@OneToMany指向的PropertyCriteria<?>是一个已映射的实体类，结合你提供的代码和原来的XML配置，我帮你拆解下问题和修复方案：

问题根源 #

1. 泛型擦除的影响：Java的泛型在运行时会被擦除，Hibernate没办法通过Set<PropertyCriteria<?>>这个泛型集合自动推断出目标实体类型，误以为PropertyCriteria是未映射的类。
2. 注解配置和原XML不匹配：原来的XML用的是单向一对多映射，外键直接放在子表PROPERTY_CRITERIA中，但你用了@JoinTable——这个注解是用来创建中间关联表的，和原XML的逻辑不符，进一步导致Hibernate无法正确解析关联关系。

修复方案 #

修改AppTerminalTypeCriteria中devicePropertiesCriteria的映射注解，让它和原XML的配置逻辑对齐，同时明确告诉Hibernate目标实体类型：

方案1：指定targetEntity（推荐，直观对应实体类） #

@javax.persistence.Entity
@Table(name = "TYPE_CRITERIA")
public class AppTerminalTypeCriteria {
    // 其他字段...
    
    @OneToMany(orphanRemoval = true, targetEntity = PropertyCriteria.class)
    @JoinColumn(name = "APP_CRITERIA_PROPERTY_ID") // 对应原XML中的<key column="APP_CRITERIA_PROPERTY_ID"/>
    @org.hibernate.annotations.Cache(usage = CacheConcurrencyStrategy.TRANSACTIONAL)
    private Set<PropertyCriteria<?>> devicePropertiesCriteria = new HashSet<>();
}

方案2：指定entityName（贴近原XML的entity-name配置） #

因为你在PropertyCriteria上用了@Entity(name="PropertyCriteria")定义了实体别名，也可以直接引用这个别名：

@javax.persistence.Entity
@Table(name = "TYPE_CRITERIA")
public class AppTerminalTypeCriteria {
    // 其他字段...
    
    @OneToMany(orphanRemoval = true, entityName = "PropertyCriteria")
    @JoinColumn(name = "APP_CRITERIA_PROPERTY_ID")
    @org.hibernate.annotations.Cache(usage = CacheConcurrencyStrategy.TRANSACTIONAL)
    private Set<PropertyCriteria<?>> devicePropertiesCriteria = new HashSet<>();
}

额外注意事项 #

• 确保PropertyCriteria及其所有子类（比如BooleanPropertyCriteria）都被Hibernate的实体扫描机制覆盖到：如果是Spring环境，要在@EntityScan中包含这些类所在的包；如果是传统Java EE，要在persistence.xml里显式声明这些实体。
• 检查数据库表结构，确保PROPERTY_CRITERIA表中确实存在APP_CRITERIA_PROPERTY_ID外键列，指向TYPE_CRITERIA的主键。

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