Doctrine查询仅返回一行结果求助（Symfony 2.7）

• 主键重复或映射错误
  Doctrine依赖实体的主键区分不同对象，若数据库中两条目标记录的主键值相同，Doctrine会将它们识别为同一个实体实例，最终只返回一条。
  解决：检查实体类@Id注解对应的数据库字段，确保两条记录的主键值唯一；同时确认实体映射中主键策略配置正确（比如自增、UUID等）。

• 查询中存在不合理的分组/去重
  即便原生SQL返回两条记录，若查询构建器中使用了groupBy()或distinct()，且分组/去重字段导致Doctrine将两条记录视为同一实体，就会出现对象集合仅返回一条的情况。
  解决：检查查询构建器代码，移除不必要的groupBy()或distinct()；若确实需要分组，确认分组逻辑不会合并需保留的实体。

• UnitOfWork一级缓存干扰
  Doctrine的UnitOfWork会缓存已加载的实体实例，若之前的操作已加载过其中一条实体，再次查询时会复用缓存对象，导致结果集被合并。
  解决：执行查询前调用$entityManager->clear()清除一级缓存，再执行查询：

$this->getEntityManager()->clear();
$result = $queryBuilder->getQuery()->getResult();

• 实体字段错误标记为唯一
  若实体中非唯一字段被错误添加unique=true注解，Doctrine在生成对象时会认为该字段值重复的记录是同一个实体，从而只返回一条。
  解决：检查实体类字段注解，比如@Column(name="xxx", unique=true)，确保仅真正需要唯一约束的字段才设置该属性。

• 关联实体的Fetch模式问题
  若查询的实体关联了其他实体，且关联的fetch模式设为EAGER但关联查询逻辑有问题，可能导致对象生成过程中丢失部分实体。
  解决：检查实体关联的fetch属性（比如@ManyToOne(fetch="EAGER")），尝试改为LAZY，或确保关联查询条件正确，不会过滤掉需要的记录。

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