Spring Boot JPA单表继承下跨子类属性查询异常解决

你遇到的PropertyReferenceException是因为Spring Data JPA的派生查询方法完全基于实体类的属性映射解析——父类ContactEntity确实没有name属性，所以无法通过方法名自动生成对应SQL。不能直接用父类中不存在的属性定义派生查询方法，但可以通过以下几种方式实现你想要的查询逻辑：

方案1：使用原生SQL查询（最贴近需求SQL） #

直接在仓库接口中用@Query注解编写原生SQL，完全匹配目标查询逻辑，同时处理分页需求：

public interface ContactRepository<T extends ContactEntity> extends JpaRepository<T, Long> {

    @Query(value = "select * from contacts c " +
                   "where lower(concat(c.firstname, c.lastname)) like lower(concat('%', :name, '%')) " +
                   "   or lower(c.companyname) like lower(concat('%', :name, '%'))",
           countQuery = "select count(*) from contacts c " +
                        "where lower(concat(c.firstname, c.lastname)) like lower(concat('%', :name, '%')) " +
                        "   or lower(c.companyname) like lower(concat('%', :name, '%'))",
           nativeQuery = true)
    Page<ContactEntity> searchByName(String name, Pageable pageable);
}

注意：原生查询需要单独指定countQuery，否则Spring Data无法自动生成分页所需的计数查询。

方案2：使用JPQL查询（面向对象，与数据库解耦） #

用JPA的JPQL语法编写查询，通过TYPE()函数区分实体类型，分别匹配子类的属性：

public interface ContactRepository<T extends ContactEntity> extends JpaRepository<T, Long> {

    @Query("SELECT c FROM ContactEntity c WHERE " +
           "(TYPE(c) = PersonEntity AND lower(concat(c.firstName, c.lastName)) like lower(concat('%', :name, '%'))) " +
           "OR (TYPE(c) = CompanyEntity AND lower(c.name) like lower(concat('%', :name, '%')))")
    Page<ContactEntity> searchByName(String name, Pageable pageable);
}

这种方式不依赖数据库特定函数，JPQL的concat是跨数据库兼容的，更符合JPA的设计理念。

方案3：子类仓库分别查询（不推荐用于分页场景） #

如果坚持想用派生查询，可以为每个子类定义独立的仓库方法，再在业务层合并结果：

定义子类仓库 #

// PersonRepository
public interface PersonRepository extends ContactRepository<PersonEntity> {
    Page<PersonEntity> findByFirstNameContainingIgnoreCaseOrLastNameContainingIgnoreCase(String firstName, String lastName, Pageable pageable);
}

// CompanyRepository
public interface CompanyRepository extends ContactRepository<CompanyEntity> {
    Page<CompanyEntity> findByNameContainingIgnoreCase(String name, Pageable pageable);
}

业务层合并结果 #

在服务类中调用两个仓库的方法，手动合并分页数据。但这种方式会触发两次数据库查询，且分页逻辑需要自行处理，比如合并后的总条数、页码计算等，仅适合简单场景。

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