在Doctrine ORM的实际开发中，经常需要基于关联实体的某个字段值，筛选对应的主实体数据，当匹配值有多个时，使用IN子句是最优的选择，能够避免多次查询带来的性能损耗。
基础场景说明
假设我们有两个关联的实体，分别是User和Order，User和Order是一对多关系，一个用户可以有多个订单，订单实体中包含status字段表示订单状态。现在需要筛选出所有拥有状态为1、2、3的订单的用户，就需要用到关联实体的status字段数组进行IN子句筛选。
使用QueryBuilder实现筛选
QueryBuilder是Doctrine ORM中最常用的查询构造工具，我们可以通过它来构造关联查询的IN条件，具体代码如下：
<?php
// 获取User实体的Repository
$userRepository = $entityManager->getRepository(User::class);
// 构造QueryBuilder
$queryBuilder = $userRepository->createQueryBuilder('u');
// 关联order实体，设置别名o
$queryBuilder->leftJoin('u.orders', 'o')
// 添加IN条件，筛选订单状态在指定数组中的记录
->where($queryBuilder->expr()->in('o.status', ':statusList'))
// 设置参数，状态数组为[1,2,3]
->setParameter('statusList', [1, 2, 3])
// 去重，避免同一个用户因为多个符合条件的订单被重复查询
->distinct();
// 执行查询获取结果
$users = $queryBuilder->getQuery()->getResult();
上述代码中，leftJoin方法用于关联用户对应的订单集合，expr()->in方法用于构造IN子句条件，setParameter方法传入需要匹配的状态数组，最后添加distinct方法避免因关联出多条符合条件的订单记录导致用户数据重复。
使用DQL语句实现筛选
如果不想使用QueryBuilder，也可以直接编写DQL语句完成同样的筛选需求，代码如下：
<?php
// 定义DQL语句，关联User和Order，筛选订单状态在指定数组中的用户
$dql = "SELECT DISTINCT u FROM User u LEFT JOIN u.orders o WHERE o.status IN (:statusList)";
// 创建查询对象
$query = $entityManager->createQuery($dql);
// 设置参数
$query->setParameter('statusList', [1, 2, 3]);
// 执行查询
$users = $query->getResult();
DQL语句的语法更接近原生SQL，但是是基于Doctrine的实体映射关系编写的，需要注意关联的路径要使用实体中定义的属性名，而不是数据库表的字段名。
常见注意事项
- 传入IN子句的数组不能为空，否则Doctrine会抛出异常，如果数组可能为空，需要先做判断，为空时直接返回空结果或者调整查询条件。
- 关联查询时要根据业务需求选择
leftJoin或者innerJoin，如果需要筛选出一定有符合条件的关联记录的主实体，使用innerJoin即可，不需要再额外加o.status IS NOT NULL的条件。 - 如果关联实体的字段是字符串类型，传入的数组元素也需要是字符串类型，避免出现类型不匹配导致的查询错误。
- 当IN子句的数组元素过多时，建议将数组拆分为多个小批次查询，避免SQL语句过长导致数据库执行效率下降。
性能优化建议
如果频繁执行这类关联IN查询，可以给关联实体的筛选字段添加索引，比如给Order实体的status字段添加索引，能够大幅提升查询速度。另外，如果只需要获取主实体的部分字段，可以在QueryBuilder或者DQL中指定需要查询的字段，减少数据传输量，进一步提升查询效率。
Doctrine_ORMIN子句关联实体查询优化数组筛选修改时间：2026-07-17 06:06:33