Doctrine关联查询：如何加载所有分类的子级实体

嘿，我之前也碰到过这个问题！你看到的uninitialized集合是Doctrine延迟加载（Lazy Loading）的典型表现——默认情况下，关联的子分类集合不会在查询父分类时自动加载，只有当你实际调用集合的方法（比如getChildren()后遍历、或者count()）时，Doctrine才会去数据库执行额外的查询。

要解决这个问题，我们可以通过Fetch Join让Doctrine在查询父分类的同时一次性加载子分类，或者根据需求处理多层级的树形结构，下面给你具体方案：

方案1：加载一级子分类（用QueryBuilder的Fetch Join） #

首先确认你的Category实体里的自引用关联大概是这样的（假设子级关联字段是$children）：

// Category.php
/**
 * @ORM\Entity(repositoryClass=CategoryRepository::class)
 */
class Category
{
    // ... 其他字段

    /**
     * @ORM\ManyToOne(targetEntity=self::class, inversedBy="children")
     * @ORM\JoinColumn(name="parent_id", referencedColumnName="id", nullable=true)
     */
    private $parent;

    /**
     * @ORM\OneToMany(targetEntity=self::class, mappedBy="parent")
     */
    private $children;

    public function __construct()
    {
        $this->children = new ArrayCollection();
    }

    // ... getter/setter 方法
}

然后在你的CategoryRepository里添加一个自定义查询方法，用leftJoin+addSelect来主动加载子分类：

// CategoryRepository.php
public function findAllWithChildren()
{
    return $this->createQueryBuilder('c')
        // 关联子分类，给子分类起别名cc
        ->leftJoin('c.children', 'cc')
        // 关键：把子分类加入查询结果，让Doctrine一次性加载
        ->addSelect('cc')
        ->getQuery()
        ->getResult();
}

这样调用这个方法后，dump出来的children集合就会是已初始化的，包含所有一级子分类数据。

方案2：加载所有层级的子分类（树形结构） #

如果你的分类是多层级的（比如父分类→子分类→孙子分类），上面的方法只能加载一级子分类。这时候有两种常用方式：

方式A：用递归SQL查询（原生SQL） #

Doctrine的DQL不支持递归查询，但我们可以用原生SQL的WITH RECURSIVE语法来查询整个树形结构：

// CategoryRepository.php
public function findAllCategoryTree()
{
    $conn = $this->getEntityManager()->getConnection();
    
    $sql = <<<SQL
WITH RECURSIVE category_tree AS (
    -- 先查询所有根分类（parent_id为null的）
    SELECT id, name, parent_id, 1 as level
    FROM category
    WHERE parent_id IS NULL
    UNION ALL
    -- 递归查询子分类，关联父分类的id
    SELECT c.id, c.name, c.parent_id, ct.level + 1
    FROM category c
    INNER JOIN category_tree ct ON c.parent_id = ct.id
)
SELECT * FROM category_tree ORDER BY level, name
SQL;

    $stmt = $conn->prepare($sql);
    $stmt->execute();
    
    // 返回关联数组，如果需要实体对象，可以用ResultSetMapping映射
    return $stmt->fetchAllAssociative();
}

方式B：用第三方树形扩展（推荐） #

如果经常需要处理树形结构的分类，推荐使用Gedmo TreeBundle（属于Doctrine Extensions），它支持Nested Set、Closure Table等多种树形结构实现，能轻松实现层级查询、移动节点等操作，比自己写递归方便多了。

为什么会出现uninitialized？ #

再补充下原理：Doctrine的关联默认是fetch="LAZY"（延迟加载），这时候$children是一个代理的ArrayCollection，只有当你实际访问它的元素时（比如foreach($category->getChildren() as $child)），Doctrine才会触发额外的SQL查询去加载数据。而Fetch Join的方式是告诉Doctrine在主查询时就把关联数据一起查出来，避免N+1查询问题。

另外，不建议直接把关联的fetch设置为EAGER（比如@ORM\OneToMany(..., fetch="EAGER")），因为这会导致每次查询Category都会加载子分类，不管你是否需要，可能造成不必要的性能开销。

最后，如果你只是想临时验证数据，也可以在dump前手动触发加载：

// 控制器里
$categories = $categoryRepository->findAll();
foreach ($categories as $category) {
    // 调用count()或者遍历，触发延迟加载
    $category->getChildren()->count();
}
dump($categories);

但这会产生N+1个查询（每个分类一个查询），只适合调试，不适合生产环境。

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