如何转换SQL为Doctrine QueryBuilder语法返回User ORM对象数组

以下实现基于你给出的业务逻辑和技术栈，默认你的Doctrine实体关联属性符合Symfony/Doctrine通用命名规范，如果实际属性名不一致，替换为你代码中定义的名称即可。

前置约定 #

假设实体关联属性定义如下：

• User实体与ContactPerson为OneToMany关联，User侧属性名为$contactPersons
• ContactPerson实体与Company为OneToMany关联，ContactPerson侧属性名为$companies
• 所有关联已在实体中通过注解/yml/xml配置好映射关系，无需手动写关联条件

实现代码 #

直接在UserRepository中添加如下方法，调用后可直接返回User ORM对象数组：

public function findUsersWithOnlyOneRelatedCompany(): array
{
    $qb = $this->createQueryBuilder('u');

    $qb->join('u.contactPersons', 'cp')
        ->join('cp.companies', 'c')
        ->groupBy('u.id')
        ->having($qb->expr()->eq('COUNT(c.id)', 1));

    return $qb->getQuery()->getResult();
}

关键注意点 #

• 不需要手动指定select字段：从UserRepository创建QueryBuilder时，默认会查询User实体的全量映射字段，getResult()会自动完成ORM hydration，直接返回User实例数组，和要求的返回格式完全一致。
• 分组使用用户主键u.id替代邮箱字段：避免不同用户使用相同邮箱导致的统计误差，主键分组也更符合数据库查询优化规则，Doctrine可正确识别实体分组逻辑。
• 联表无需手动拼接ON条件：只要实体关联映射配置正确，Doctrine会自动生成和你原生SQL一致的INNER JOIN逻辑。如果你的实体关联属性名和约定不一致，仅需修改join方法内的属性路径即可，比如ContactPerson关联Company的属性为$relatedCompanies时，将cp.companies替换为cp.relatedCompanies即可。
• 若需要验证生成的SQL是否符合预期，可在return前调用$qb->getQuery()->getSQL()打印语句和你写的原生SQL做对比。

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