ServiceEntityRepository如何查询主实体与关联实体的指定字段

解决方案 #

可以通过DQL实现主实体和关联实体的指定字段查询，你遇到的问题是DQL选择规则不熟悉和拼写错误导致的，以下是具体修复方案：

问题原因梳理 #

• 报错Cannot select entity through identification variables without choosing at least one root entity alias是因为你混合了「部分标量字段选择」和「完整实体选择」，Doctrine的DQL不支持这种混合选择模式，要么选完整实体，要么统一选择指定字段。
• 注释addSelect后没有子分类数据，是因为Doctrine默认不会预加载join的关联数据，必须通过addSelect显式指定要返回关联数据才会加载。
• 去掉select返回全量字段是默认行为，Doctrine会查询实体映射的所有数据库字段。

方案1：使用PARTIAL语法保留关联结构（推荐） #

PARTIAL是Doctrine提供的部分字段查询语法，可以在保留实体关联结构的前提下仅查询指定字段，不需要额外格式化数据：

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

    public function getEnabledCategories(): array
    {
        $qb = $this->createQueryBuilder('category')
            // 指定主分类仅返回id、fullName字段
            ->select('PARTIAL category.{id, fullName}')
            // 指定子分类仅返回id、fullName字段
            ->addSelect('PARTIAL subCategory.{id, fullName}')
            // 修正拼写错误：subCategoreis → subCategories
            ->leftJoin(
                'category.subCategories',
                'subCategory'
            )
            ->where('category.enabled = :categoryEnabled')
            ->andWhere('subCategory.enabled = :categoryEnabled')
            ->setParameter('categoryEnabled', true, Types::BOOLEAN)
            ->orderBy('category.id', 'ASC');

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

返回结果会保持「分类下嵌套子分类数组」的结构，所有实体仅包含你指定的字段，无冗余。

方案2：纯标量查询手动格式化 #

如果你需要完全自定义返回的数组结构，可以直接选择标量字段后手动分组：

public function getEnabledCategories(): array
{
    $qb = $this->createQueryBuilder('category')
        ->select([
            'category.id as cid',
            'category.fullName as cname',
            'subCategory.id as sid',
            'subCategory.fullName as sname'
        ])
        ->leftJoin('category.subCategories', 'subCategory')
        ->where('category.enabled = :categoryEnabled')
        ->andWhere('subCategory.enabled = :categoryEnabled')
        ->setParameter('categoryEnabled', true, Types::BOOLEAN)
        ->orderBy('category.id', 'ASC');

    $raw = $qb->getQuery()->getScalarResult();
    $result = [];
    foreach ($raw as $item) {
        // 按主分类ID分组
        if (!isset($result[$item['cid']])) {
            $result[$item['cid']] = [
                'id' => $item['cid'],
                'fullName' => $item['cname'],
                'subCategories' => []
            ];
        }
        $result[$item['cid']]['subCategories'][] = [
            'id' => $item['sid'],
            'fullName' => $item['sname']
        ];
    }
    // 重置索引返回数组
    return array_values($result);
}

额外优化提示 #

你当前的写法中，leftJoin后在where条件限制子分类启用，会自动转为innerJoin，没有符合条件子分类的主分类会被过滤。如果需要保留无子分类的主分类，需要把子分类的启用条件放到join的自定义条件中：

->leftJoin(
    'category.subCategories',
    'subCategory',
    'WITH',
    'subCategory.enabled = :categoryEnabled'
)
// 仅保留主分类的启用条件
->where('category.enabled = :categoryEnabled')

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