如何通过Doctrine ORM EntityManager仅获取实体指定字段？

你说得完全正确，用findBy()这类Doctrine Repository的快捷查询方法确实没办法指定只获取部分字段——这类方法的设计目标就是返回完整的实体对象，所以会自动加载该实体的所有持久化属性，不管你实际需要哪些。

为什么findBy()不行？ #

Doctrine ORM的核心是对象关系映射（ORM），findBy()、findOneBy()、find()这些方法都是围绕「完整实体实例」来设计的。当你调用这些方法时，Doctrine会把数据库查询结果自动「水合」（hydrate）成对应的实体对象，这意味着必须加载所有映射的字段，才能构建出一个完整、合法的实体实例。

可行的解决方案：用QueryBuilder或DQL查询特定字段 #

既然快捷方法走不通，就需要用更灵活的查询方式，你已经实现的QueryBuilder方案就是标准且推荐的做法，这里再细化说明一下，同时补充其他可选方式：

1. QueryBuilder方式（推荐）

你写的代码已经很规范了，这里再贴出来并解释关键点：

$query = $this->entityManager->createQueryBuilder();
$users = $query->select('u.username') // 指定要获取的字段，多个字段用逗号分隔，比如'u.username, u.location'
               ->from(User::class, 'u') // 关联User实体，设置别名u
               ->where('u.username = :username') // 查询条件
               ->setParameter('username', $username) // 参数绑定，防止SQL注入
               ->getQuery()
               ->execute();

• 执行后返回的是一个关联数组的集合（如果只查单个字段，就是一维数组的集合，比如[['username' => 'xxx'], ['username' => 'yyy']]）
• 如果需要返回单个结果，可以用getOneOrNullResult()代替execute()

2. 原生DQL查询

如果你更习惯写类似SQL的语法，也可以直接用DQL：

$query = $this->entityManager->createQuery(
    'SELECT u.username FROM App\Entity\User u WHERE u.username = :username'
);
$query->setParameter('username', $username);
$users = $query->execute();

效果和QueryBuilder完全一致，只是写法不同。

3. 部分实体（Partial Entities，慎用）

如果确实需要返回User对象而不是数组，Doctrine支持「部分实体」的写法，但这属于非官方特性，可能在版本更新中出现兼容性问题，而且懒加载相关的逻辑可能会出问题，所以只建议在简单场景下使用：

$users = $query->select('PARTIAL u.{id, username}') // 指定要包含的实体属性，必须包含主键（比如id）
               ->from(User::class, 'u')
               ->where('u.username = :username')
               ->setParameter('username', $username)
               ->getQuery()
               ->execute();

返回的是User对象，但只有指定的属性被赋值，其他属性为null或默认值。

总结 #

• findBy()等快捷查询方法只能返回完整实体，无法指定字段；
• 要获取特定字段，优先使用QueryBuilder或DQL，返回数组是最安全可靠的方式；
• 部分实体写法慎用，除非你明确知道自己在做什么。

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