Symfony4下DQL配合KnpPaginatorBundle实现多字段GROUP BY查询

使用Doctrine查询构建器编写分组查询时，如果不主动指定select的返回字段，默认会拉取对应实体的所有映射列，包括主键id。这种查询模式和多字段GROUP BY的SQL语法规则天然冲突——在开启了ONLY_FULL_GROUP_BY的数据库配置下，所有SELECT中出现的非聚合字段，必须全部出现在GROUP BY子句中，默认带的id字段不在分组规则里，就会直接抛出语法错误，也没法返回预期的精简业务字段。
目前验证可正常运行的原生SQL完全符合规则：仅选取objet、marque、type三个字段，且三个字段全部对应到GROUP BY的分组维度，没有多余字段干扰。

核心改造思路是摒弃默认查全实体的写法，手动指定查询返回的字段集，完全对齐原生SQL的逻辑：

// 位于 StockRepository 自定义查询方法内
$queryBuilder = $this->createQueryBuilder('s');

// 手动指定需要返回的业务字段，给属性起和原生SQL一致的别名，避免后续取值适配成本
$queryBuilder->select('s.objet, s.brand AS marque, s.model AS type')
    // 保留原有业务筛选条件逻辑
    ->andWhere(/* 原有筛选规则 */)
    // 对应原生SQL的分组维度
    ->addGroupBy('s.objet')
    ->addGroupBy('s.brand')
    ->addGroupBy('s.model')
    // 对应原生SQL的排序规则
    ->addOrderBy('s.brand', 'ASC')
    ->addOrderBy('s.model', 'ASC');

// 直接返回Query对象即可，无需额外原生SQL转换
return $queryBuilder->getQuery();

• 绝对不要在select中写select('s')触发全实体映射，这是GROUP BY规则冲突的核心诱因
• 所有写在select子句里的非聚合字段，必须全部加入addGroupBy规则，否则依然会触发数据库语法校验错误
• 这套写法可以直接传入KnpPaginatorBundle的分页方法，分页组件会自动处理总条数统计、分页偏移逻辑，返回的结果结构和现有原生SQL的返回结构完全一致，不需要修改上层业务代码
• 如果分页时遇到总条数统计异常，只需要在调用分页器时传入distinct => false参数，分页器会自动适配分组查询的总条数计算逻辑，不需要手动重写count查询
• 如果需要展示每组的聚合指标（比如同型号总库存数），只需要在select中追加聚合表达式即可，例如：$queryBuilder->select('s.objet, s.brand AS marque, s.model AS type, COUNT(s.id) AS total_stock')

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