Symfony6+API Platform按虚拟列排序时分页计数错误问题

数据老陈

2026-6-23

Symfony 6 + API Platform 按关联表聚合列排序时分页总数错误的解决方法

问题背景

使用Symfony 6和API Platform实现按职位总数排序公司功能时，原生SQL能正确返回2家公司的聚合结果，但通过Doctrine Extension实现后，API返回的hydra:totalItems显示为6（与Opening表的行数一致），而非实际的公司数量2。

核心原因

多余的分组条件：代码中手动添加了->addGroupBy('openings_a1.id')，导致Doctrine按每个Opening的ID分组，结果行数与Opening表记录数（6条）一致，而非按Company聚合。
关联类型不匹配：使用innerJoin而非原生SQL中的leftJoin，虽当前数据无影响，但会丢失无职位的公司，且逻辑与原生查询不一致。
分页计数逻辑：API Platform的hydra:totalItems是基于Doctrine查询的结果行数，错误分组导致计数错误。

修复方案

步骤1：移除错误的分组条件

删除手动添加的->addGroupBy('openings_a1.id')，仅保留按Company主键分组的条件。

步骤2：替换关联类型为Left Join

将innerJoin改为leftJoin，与原生SQL逻辑对齐，确保无职位的公司也能被查询到。

修复后的完整代码

$alias = $queryBuilder->getRootAliases()[0];
$queryBuilder
    ->leftJoin(sprintf('%s.openings', $alias), 'job')
    ->addSelect('SUM(job.positions) AS HIDDEN job_positions')
    ->orderBy('job_positions', 'DESC')
    ->addGroupBy(sprintf('%s.id', $alias));

代码说明

leftJoin：保持与原生SQL一致的关联逻辑，避免过滤掉无职位的公司。
SUM(job.positions) AS HIDDEN job_positions：计算每个公司的职位总数，HIDDEN关键字确保该字段仅用于排序，不会被序列化到API响应中。
仅按Company ID分组：让Doctrine正确聚合每个公司的职位数据，结果行数等于公司数量（2条），从而修正hydra:totalItems的计数。