JPA泛型集合映射报错：如何复用父类Repository避免代码冗余？

问题根源 #

你遇到的ClassCastException: GenericArrayTypeImpl cannot be cast to ParameterizedType，本质是JPA规范及主流实现（如Hibernate）不支持泛型数组作为持久化字段。JPA对泛型的类型解析仅针对Collection、List、Set这类集合接口，泛型数组的类型信息在运行时会被擦除，且元数据解析器无法处理GenericArrayType到ParameterizedType的转换逻辑。

可行修复方案 #

1. 将泛型数组替换为泛型集合（推荐） #

把父类中@OneToMany注解的泛型数组字段换成泛型List<T>，这是最直接且符合JPA规范的做法：

@MappedSuperclass
public abstract class SuperClass<T> {
    // 替换泛型数组为List<T>
    @OneToMany
    protected List<T> genericField;
    
    // 其他通用字段...
}

子类重写关联映射时，只需调整@OneToMany的mappedBy、targetEntity或列配置即可，完全不影响复用逻辑：

@Entity
@Table(name = "sub_table")
public class SubClass extends SuperClass<RelatedEntity> {
    @Override
    @OneToMany(mappedBy = "subClass", cascade = CascadeType.ALL)
    @Column(name = "custom_generic_field")
    public List<RelatedEntity> getGenericField() {
        return super.getGenericField();
    }
    
    // 重写field4的列名...
}

父类Repository的JPQL构造函数查询无需修改，依然可以复用，因为集合类型的泛型信息能被JPA正确解析。

2. 若必须使用数组的折中方案 #

如果业务逻辑强制要求数组类型，可在父类保留泛型集合作为持久化字段，子类新增@Transient标记的数组字段做转换：

@MappedSuperclass
public abstract class SuperClass<T> {
    @OneToMany
    protected List<T> genericField;
    
    // 其他通用字段...
}

@Entity
@Table(name = "sub_table")
public class SubClass extends SuperClass<RelatedEntity> {
    @Transient
    private RelatedEntity[] genericArray;
    
    @PostLoad
    private void convertToListToArray() {
        this.genericArray = super.getGenericField().toArray(new RelatedEntity[0]);
    }
    
    // 重写关联映射和field4...
}

这种方式既满足JPA的持久化要求，又能通过非持久化字段提供数组类型的访问，同时不破坏父类Repository的复用逻辑。

关于原方案的说明 #

你的原方案中，在@MappedSuperclass使用泛型数组作为@OneToMany字段的操作，属于JPA不支持的场景。主流JPA实现都没有针对泛型数组做类型解析适配，因此会触发类型转换异常。将字段移到子类导致的Repository复用问题，本质也是因为子类脱离了父类的泛型集合上下文，无法复用父类的JPQL查询。

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