Hibernate泛型Repository查询子类属性报错，如何解决？

这个报错的核心原因是Spring Data JPA没有正确识别你要查询的实际实体类型。虽然你的AuditRepository声明了泛型E extends IdBase，但当你直接使用这个泛型仓库（而非它的子类仓库）时，框架会将泛型的边界类型IdBase当作要处理的ManagedType——但IdBase是@MappedSuperclass，它本身不是实体，也没有subTitle这个属性，自然会触发找不到属性的报错。

@MappedSuperclass的作用是提取实体的公共映射字段，它本身不会被JPA视为可管理的实体类型，只有继承它的子类（比如SubEmployeeEntity）才是真正的实体。

你需要让Spring Data JPA明确知道你要操作的实际实体子类，有三种常用的解决方式：

1. 为每个实体子类创建专属的仓库接口（推荐） #

这是最规范且易维护的做法，让每个实体都有自己的仓库，继承你的泛型AuditRepository：

@Repository
public interface SubEmployeeRepository extends AuditRepository<SubEmployeeEntity, Long> {
    // 这里可以添加SubEmployeeEntity专属的查询方法，比如
    List<SubEmployeeEntity> findBySubTitle(String subTitle);
}

之后你在业务代码中注入SubEmployeeRepository而非AuditRepository，框架就能正确识别SubEmployeeEntity作为目标实体，自然能找到subTitle属性。

2. 动态查询时明确指定实体类型 #

如果是使用Specification进行动态查询，要确保在构建Specification时指定具体的实体子类类型，而不是泛型的IdBase：

// 错误写法：用Root<IdBase>会导致找不到子类属性
Specification<IdBase> wrongSpec = (root, query, cb) -> 
    cb.equal(root.get("subTitle"), "test");

// 正确写法：指定Root为SubEmployeeEntity
Specification<SubEmployeeEntity> correctSpec = (root, query, cb) -> 
    cb.equal(root.get("subTitle"), "test");

如果泛型仓库中有自定义方法，也可以通过传入实体Class的方式让框架识别类型：

@Repository
public interface AuditRepository<E extends IdBase> extends JpaRepository<E, Long>, JpaSpecificationExecutor<E> {
    <T extends E> List<T> findByCreatedBy(String createdBy, Class<T> entityClass);
}

调用时传入SubEmployeeEntity.class，框架就能基于这个Class识别实体属性。

3. 修正JPQL查询语句（如果使用@Query） #

如果你的仓库方法用了@Query注解，要确保JPQL中引用的是实体子类的名称，而非IdBase：

// 错误写法：FROM IdBase会指向映射超类
@Query("SELECT e FROM IdBase e WHERE e.subTitle = ?1")
List<E> findBySubTitle(String subTitle);

// 正确写法：FROM实际实体子类
@Query("SELECT e FROM SubEmployeeEntity e WHERE e.subTitle = ?1")
List<SubEmployeeEntity> findBySubTitle(String subTitle);

核心思路就是让Spring Data JPA明确知道你要操作的实际实体子类，而不是只看到泛型的边界类IdBase。创建子类专属仓库是最简洁且易维护的方案，推荐优先使用。

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