JPA JOINED继承策略查询报错：Column 'clazz_' not found

错误原因 #

当使用InheritanceType.JOINED继承策略时，Hibernate处理多态实体（如抽象基类Activity）的查询时，需要一个鉴别列（默认名为clazz_）来区分不同的子类（Exercise、Contest），以此实例化正确的子类对象。但你用原生SQL直接查询activity表时，既没有提供这个鉴别列，也没有关联对应的子类表，导致Hibernate无法识别每条记录对应的子类，从而抛出Column 'clazz_' not found错误。

解决方案 #

方案一：使用JPQL替代原生SQL（推荐） #

JPQL会自动适配Hibernate的继承机制，无需手动处理表关联或鉴别列，有两种实现方式：

方式1：Spring Data JPA方法命名查询

直接定义符合命名规范的方法，Spring Data JPA会自动生成正确的查询语句：

public interface ActivityRepository extends JpaRepository<Activity, Integer>{
    List<Activity> findByCourseId(int courseId);
}

方式2：自定义JPQL查询

如果需要更灵活的查询逻辑，编写JPQL语句：

public interface ActivityRepository extends JpaRepository<Activity, Integer>{
    @Query("SELECT a FROM Activity a WHERE a.course.id = :courseId")
    List<Activity> getByCourseId(@Param("courseId") int courseId);
}

以上两种方式都会让Hibernate自动生成关联子类表的SQL，正确处理子类的鉴别逻辑，返回对应的Exercise或Contest实例。

方案二：坚持使用原生SQL（不推荐） #

必须手动关联所有子类表，并添加鉴别列标识，让Hibernate识别子类：

public interface ActivityRepository extends JpaRepository<Activity, Integer>{
    @Query(value = "SELECT a.*, 'Exercise' as clazz_ FROM activity a JOIN exercise e ON a.activity_id = e.activity_id WHERE a.course_id=:courseId " +
                   "UNION ALL " +
                   "SELECT a.*, 'Contest' as clazz_ FROM activity a JOIN contest c ON a.activity_id = c.activity_id WHERE a.course_id=:courseId", 
           nativeQuery = true)
    List<Activity> getByCourseId(@Param("courseId") int courseId);
}

这里通过UNION ALL合并两个子类的查询结果，手动添加clazz_列并赋值为子类类名（需与Hibernate内部鉴别值一致）。但这种方式扩展性差，新增子类时必须修改SQL，因此优先推荐方案一。

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