如何用 Spring Data JPA 查询被关联次数最多的实体

本文介绍如何通过单条 jpql 查询，高效统计并排序那些在两个关联表（如 `itemcounter1` 和 `itemcounter2`）中出现频次最高的主实体（`item`），充分利用数据库聚合能力，避免多次查询与内存合并。

在 Spring Data JPA 中，当需要基于多张关联表的计数结果对主实体进行排序（例如“最热门商品”“最高频访问项”），直接使用 @Query 编写聚合 JPQL 是最佳实践——它将计算压力下推至数据库，显著提升性能与可维护性。

但需特别注意：JPQL 中 SELECT 子句若包含非聚合字段（如 i，即整个 Item 实体），则 GROUP BY 必须显式包含该实体的所有标识字段（通常是主键）。否则 Hibernate 会抛出 org.hibernate.hql.internal.ast.QuerySyntaxException: unexpected token 或类似错误，因为 JPQL 遵循 SQL 的严格分组语义。

你原始查询的主要问题在于 GROUP BY 缺失了 i.id，导致无法合法投影 Item 实例。修正后的完整 JPQL 如下：

public interface ItemRepository extends JpaRepository {
    @Query("""
        SELECT i
        FROM Item i
            LEFT JOIN ItemCounter1 counter1 ON i.id = counter1.itemId
            LEFT JOIN ItemCounter2 counter2 ON i.id = counter2.itemId
        WHERE (counter1.datetime IS NOT NULL AND counter1.datetime >= :fromDate)
           OR (counter2.datetime IS NOT NULL AND counter2.datetime >= :fromDate)
        GROUP BY i.id, i.createdAt, i.updatedAt  -- ✅ 包含 Item 所有非聚合选中字段（按 AbstractEntity 实际字段调整）
        ORDER BY COUNT(counter1.itemId) + COUNT(counter2.itemId) DESC
        """)
    Page findMostCounted(ZonedDateTime fromDate, Pageable pageable);
}

⚠️ 关键修正说明：

ARC Lab

腾讯旗下ARC实验室推出的AI人像修复、抠图和增强工具

下载

• GROUP BY 必须包含 i.id（主键），且若 Item 实体在 SELECT i 中被整体引用，Hibernate 会要求 GROUP BY 覆盖其所有非聚合属性（如 createdAt, updatedAt 等）。更稳妥的方式是显式投影 ID 并手动关联（见进阶方案）；
• WHERE 条件逻辑优化：原查询使用 AND 会强制要求每个 Item 同时在两张表中均有满足时间条件的记录，这通常不符合“总频次最高”的业务意图。应改为 OR，并用 IS NOT NULL 排除因 LEFT JOIN 产生的空匹配；
• Pageable 替代 PageRequest.of()：方法签名推荐使用 Pageable 参数，以兼容 Spring Data 分页标准；
• LEFT JOIN vs INNER JOIN：此处保留 LEFT JOIN 可确保零计数的 Item 也被纳入（计数为 0），若仅需至少有一次记录的项，可改用 INNER JOIN 提升性能。

✅ 进阶推荐（更健壮、可读性更强）：

@Query("""
    SELECT i.id
    FROM Item i
        LEFT JOIN ItemCounter1 c1 ON i.id = c1.itemId AND c1.datetime >= :fromDate
        LEFT JOIN ItemCounter2 c2 ON i.id = c2.itemId AND c2.datetime >= :fromDate
    GROUP BY i.id
    ORDER BY COUNT(c1.itemId) + COUNT(c2.itemId) DESC
    """)
List findMostCountedIds(ZonedDateTime fromDate);

// 再通过 findByIdIn() 批量查实体（适用于结果集不大时）
default Page findMostCounted(ZonedDateTime fromDate, Pageable pageable) {
    List ids = findMostCountedIds(fromDate).subList(
        (int) pageable.getOffset(),
        Math.min((int) pageable.getOffset() + pageable.getPageSize(), 
                 findMostCountedIds(fromDate).size())
    );
    return PageableExecutionUtils.getPage(
        findAllById(ids),
        pageable,
        () -> (long) findMostCountedIds(fromDate).size()
    );
}

此方式分离了“聚合排序”与“实体加载”，规避了 JPQL 对 GROUP BY 的严苛限制，同时保持数据库层高效计数，是生产环境更推荐的模式。

总结：聚合查询的核心是 GROUP BY 与 SELECT 语义一致 + WHERE 条件准确表达业务逻辑。善用数据库聚合能力，能让复杂统计类需求简洁、高效、可扩展。