findBy() 不支持复杂排序，仅支持主表字段的简单 ASC/DESC 排序；按关联字段、表达式或动态排序需改用 QueryBuilder 或 DQL，并注意白名单校验、JOIN 显式声明及安全拼接。
findBy() 本身不支持排序，必须用其他方式补足
findBy() 是 Doctrine Repository 提供的快捷方法，只接受条件数组和可选的 orderBy 数组 —— 但它的 orderBy 参数仅支持字段名字符串（如 'createdAt'）和方向（'ASC' 或 'DESC'），**不支持表达式、函数、关联字段别名或复合排序逻辑**。一旦你需要按关联表字段排序、用 COALESCE 处理 NULL、或动态拼接多级排序，findBy() 就会失效。
按主表字段排序：直接传 orderBy 数组即可
这是 findBy() 唯一安全可用的排序场景。例如查所有启用状态的用户并按注册时间倒序：
php
$users = $userRepository->findBy(
['status' => 'active'],
['createdAt' => 'DESC']
);
- 字段名必须是实体属性名（不是数据库列名），且该属性需有对应 getter 或 public 访问权限
- 方向只能是
'ASC'或'DESC'，不能写成1或-1 - 不支持多个字段混合方向（如
['createdAt' => 'DESC', 'name' => 'ASC']是合法的，但 Doctrine 2.x 默认不保证顺序稳定性；Symfony 6+ 中已稳定支持） - 若字段不存在或拼写错误，不会报错，只会静默忽略排序 —— 这是常见盲点
按关联字段排序：必须用 QueryBuilder 或 DQL
比如想按用户所属部门名称排序，findBy() 无法穿透 user.department.name。此时要显式 JOIN：
php
$qb = $this->createQueryBuilder('u');
$qb->leftJoin('u.department', 'd')
->addSelect('d')
->where('u.status = :status')
->setParameter('status', 'active')
->addOrderBy('d.name', 'ASC')
->addOrderBy('u.createdAt', 'DESC');
return $qb->getQuery()->getResult();
-
addOrderBy('d.name')中的d是 JOIN 别名，不是实体关系名；漏掉leftJoin()直接写addOrderBy('u.department.name')会报 DQL 解析错误 - 记得
addSelect('d')，否则即使排序生效，d实体可能不会被 hydrate 出来（尤其在getResult()模式下） - 如果只是排序用、不需要返回关联对象，可以省略
addSelect()，但必须保留leftJoin()，否则ORDER BY无数据源
动态排序字段和方向：QueryBuilder 更可控，避免 eval 或拼接 SQL
前端传参如 ?sort=updatedAt&direction=desc，不能直接塞进 findBy() 的 orderBy 数组，因为字段合法性未校验。正确做法是白名单过滤后注入 QueryBuilder：
php
$allowedSorts = ['createdAt', 'updatedAt', 'name'];
$sortField = $request->query->get('sort', 'createdAt');
$sortDirection = strtoupper($request->query->get('direction', 'ASC'));
$sortDirection = in_array($sortDirection, ['ASC', 'DESC']) ? $sortDirection : 'ASC';
if (!in_array($sortField, $allowedSorts)) {
$sortField = 'createdAt';
}
$qb = $this->createQueryBuilder('u');
$qb->where('u.status = :status')->setParameter('status', 'active');
$qb->addOrderBy('u.' . $sortField, $sortDirection);
return $qb->getQuery()->getResult();
- 永远不要把用户输入直接拼进 DQL 字符串（如
"ORDER BY {$sortField}"），防止 SQL 注入 -
addOrderBy()支持多次调用，适合构建多级排序逻辑（如先按状态，再按时间） - 注意：Doctrine 不支持在
orderBy中使用参数占位符（:sortField），字段名必须是硬编码或白名单校验后的字符串
findBy() 切换到 QueryBuilder 后，getResult() 返回的是纯数组或对象列表，不再自动处理分页元数据或缓存键生成逻辑 —— 如果你之前依赖 findBy() 的简单性做批量操作，这里需要手动对齐行为。 
