JPA JOINED策略下如何高效搜索Person/Organization继承的Partner实体

针对你遇到的JOINED继承结构下的搜索性能问题，以下是几个实用的优化方案：

1. 拆分查询，避免不必要的表关联 #

因为entityType已经明确区分了合作伙伴类型，完全可以针对Person和Organization分别编写查询，避免同时关联两张无关的表。

实现方式： #

编写两个独立的查询方法，分别处理个人和组织类型的搜索，再在业务层按需合并结果：

// 查询个人类型合作伙伴
@Query("""
SELECT new com.example.api.PartnerResponseDto(
    p.id,
    p.partnerType,
    p.entityType,
    p.email,
    p.createdAt,
    p.updatedAt,
    p.firstName,
    p.lastName,
    null,
    null,
    null
)
FROM Person p
WHERE p.partnerType = :partnerType
AND (:searchTerm IS NULL OR :searchTerm = '' OR CONCAT(p.firstName, ' ', p.lastName) LIKE CONCAT('%', :searchTerm, '%'))
""")
Page<PartnerResponseDto> findPersonPartners(
    @Param("partnerType") PartnerType partnerType,
    @Param("searchTerm") String searchTerm,
    Pageable pageable
);

// 查询组织类型合作伙伴
@Query("""
SELECT new com.example.api.PartnerResponseDto(
    p.id,
    p.partnerType,
    p.entityType,
    p.email,
    p.createdAt,
    p.updatedAt,
    null,
    null,
    p.companyName,
    p.registrationNumber,
    p.taxNumber
)
FROM Organization p
WHERE p.partnerType = :partnerType
AND (:searchTerm IS NULL OR :searchTerm = '' OR p.companyName LIKE CONCAT('%', :searchTerm, '%'))
""")
Page<PartnerResponseDto> findOrganizationPartners(
    @Param("partnerType") PartnerType partnerType,
    @Param("searchTerm") String searchTerm,
    Pageable pageable
);

业务层合并结果示例：

public Page<PartnerResponseDto> searchPartners(PartnerType partnerType, String searchTerm, Pageable pageable) {
    Page<PartnerResponseDto> personPage = partnerRepo.findPersonPartners(partnerType, searchTerm, pageable);
    Page<PartnerResponseDto> orgPage = partnerRepo.findOrganizationPartners(partnerType, searchTerm, pageable);
    
    List<PartnerResponseDto> combinedContent = new ArrayList<>();
    combinedContent.addAll(personPage.getContent());
    combinedContent.addAll(orgPage.getContent());
    
    return new PageImpl<>(combinedContent, pageable, personPage.getTotalElements() + orgPage.getTotalElements());
}

2. 使用UNION ALL合并查询，利用索引优化 #

如果需要一次性返回所有类型的结果，用UNION ALL替代原查询中的OR和左连接，让数据库分别执行两个高效的子查询后再合并结果，每个子查询都能利用对应表的索引：

@Query("""
SELECT new com.example.api.PartnerResponseDto(
    p.id,
    p.partnerType,
    p.entityType,
    p.email,
    p.createdAt,
    p.updatedAt,
    pe.firstName,
    pe.lastName,
    null,
    null,
    null
)
FROM Person pe
JOIN Partner p ON pe.id = p.id
WHERE p.partnerType = :partnerType
AND (:searchTerm IS NULL OR :searchTerm = '' OR CONCAT(pe.firstName, ' ', pe.lastName) LIKE CONCAT('%', :searchTerm, '%'))
UNION ALL
SELECT new com.example.api.PartnerResponseDto(
    p.id,
    p.partnerType,
    p.entityType,
    p.email,
    p.createdAt,
    p.updatedAt,
    null,
    null,
    o.companyName,
    o.registrationNumber,
    o.taxNumber
)
FROM Organization o
JOIN Partner p ON o.id = p.id
WHERE p.partnerType = :partnerType
AND (:searchTerm IS NULL OR :searchTerm = '' OR o.companyName LIKE CONCAT('%', :searchTerm, '%'))
""")
Page<PartnerResponseDto> findPartners(
    @Param("partnerType") PartnerType partnerType,
    @Param("searchTerm") String searchTerm,
    Pageable pageable
);

注意：部分JPA实现对UNION ALL的分页支持需要将合并结果作为子查询处理，若遇到分页异常，可调整为嵌套查询形式。

3. 优化模糊搜索性能，使用全文索引 #

原查询中CONCAT + LIKE '%xxx%'会触发全表扫描，无法利用普通索引。针对模糊搜索场景，建议使用数据库的全文索引功能：

示例（MySQL）： #

给Person表的名字字段创建全文索引：

ALTER TABLE person ADD FULLTEXT INDEX idx_person_fullname (first_name, last_name);

给Organization表的公司名字段创建全文索引：

ALTER TABLE organization ADD FULLTEXT INDEX idx_org_name (company_name);

修改JPQL查询为全文搜索语法：

// 个人类型查询
@Query("""
SELECT new com.example.api.PartnerResponseDto(...)
FROM Person p
WHERE p.partnerType = :partnerType
AND (:searchTerm IS NULL OR :searchTerm = '' OR MATCH(p.firstName, p.lastName) AGAINST(:searchTerm IN BOOLEAN MODE))
""")

// 组织类型查询
@Query("""
SELECT new com.example.api.PartnerResponseDto(...)
FROM Organization p
WHERE p.partnerType = :partnerType
AND (:searchTerm IS NULL OR :searchTerm = '' OR MATCH(p.companyName) AGAINST(:searchTerm IN BOOLEAN MODE))
""")

不同数据库的全文搜索语法略有差异（如PostgreSQL使用to_tsquery），请根据实际使用的数据库调整。

4. 利用JPA继承特性，直接查询子类 #

由于使用了JOINED继承策略，JPA会自动处理子类与父类表的关联，直接查询子类可以避免手动编写JOIN语句，代码更简洁且性能更优：

比如查询Person子类时，JPA会自动关联Partner表，因此可以直接访问父类的partnerType、email等字段：

@Query("""
SELECT new com.example.api.PartnerResponseDto(
    p.id,
    p.partnerType,
    p.entityType,
    p.email,
    p.createdAt,
    p.updatedAt,
    p.firstName,
    p.lastName,
    null,
    null,
    null
)
FROM Person p
WHERE p.partnerType = :partnerType
AND (:searchTerm IS NULL OR :searchTerm = '' OR CONCAT(p.firstName, ' ', p.lastName) LIKE CONCAT('%', :searchTerm, '%'))
""")
Page<PartnerResponseDto> findPersonPartners(...);

内容的提问来源于stack exchange，提问作者Ala Haj Saad