Symfony Doctrine中如何使用orderBy rand实现随机排序查询

原有写法失效原因 #

findBy(array $criteria, array $orderBy = null, $limit = null, $offset = null)方法对$orderBy参数有固定格式要求：

• 数组键必须是实体已做ORM映射的字段名
• 数组值仅支持传入ASC/DESC两种固定排序方向
  你写的[ 'name' => 'rand()' ]不符合参数规则，Doctrine会把rand()识别为非法排序方向，不会将其解析为SQL函数，也不会自动调用你安装的beberlei/doctrineextensions扩展做语法解析，自然无法生效。

前置配置检查 #

先确认Doctrine配置中已经注册了扩展提供的RAND函数，Symfony项目直接修改config/packages/doctrine.yaml，添加如下配置：

doctrine:
    orm:
        dql:
            numeric_functions:
                Rand: DoctrineExtensions\Query\Mysql\Rand

正确实现方案（推荐） #

内置findBy不支持在排序子句中传入自定义函数，最规范的实现是在对应实体的Repository中自定义查询方法，通过QueryBuilder构造DQL调用RAND函数：

1. 先在PeopleRepository（如果你的实体类名是小写people就对应调整类名）中新增查询方法：

<?php
namespace App\Repository;

use App\Entity\People;
use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
use Doctrine\Persistence\ManagerRegistry;

class PeopleRepository extends ServiceEntityRepository
{
    public function __construct(ManagerRegistry $registry)
    {
        parent::__construct($registry, People::class);
    }

    /**
     * 获取指定数量的随机可见人员数据
     * @param int $limit 返回结果条数
     * @return People[]
     */
    public function findRandomVisible(int $limit = 8): array
    {
        return $this->createQueryBuilder('p')
            ->andWhere('p.visible = :visible')
            ->setParameter('visible', true)
            ->orderBy('RAND()')
            ->setMaxResults($limit)
            ->getQuery()
            ->getResult();
    }
}

2. 业务代码中直接调用该方法即可：

$randomList = $this->entityManager->getRepository(People::class)->findRandomVisible(8);

性能提示：ORDER BY RAND()写法在表数据量超过10万条时查询性能会明显下降，大数据量场景建议改用「随机生成ID区间再匹配数据」的方案优化。

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