Laravel 无限嵌套分类树与聚合计数的高效实现方案-php教程-PHP中文网

Laravel 无限嵌套分类树与聚合计数的高效实现方案

本文介绍如何在 Laravel 中高效构建无限嵌套分类树，同时避免 N+1 查询和重复 withCount，通过一次查询获取全量分类数据，并在内存中递归聚合子类的帖子（posts）与主题（threads）总数。

本文介绍如何在 laravel 中高效构建无限嵌套分类树，同时避免 n+1 查询和重复 `withcount`，通过一次查询获取全量分类数据，并在内存中递归聚合子类的帖子（posts）与主题（threads）总数。

在 Laravel 中处理多级分类（如 categories 表自关联）并统计关联资源（如 posts 和 threads）时，直接使用递归关系（如 loopInfinite）配合多层 withCount 会导致严重的性能问题：不仅触发大量嵌套 SQL 查询，还会使 withCount 仅作用于当前层级，无法自动累加子分类的数据。

✅ 推荐方案：分离「数据获取」与「树构建」
先用单次高效查询加载全部分类及其本级统计，再在 PHP 层构建树结构并递归汇总子节点计数：

1. 一次性查询所有分类及本级统计

$categories = Category::withCount(['posts', 'threads'])
    ->orderBy('order')
    ->get();

该语句生成一条 SQL（含两个左连接子查询），返回所有分类记录，每条包含 posts_count 和 threads_count 字段，无 N+1 风险。

2. 构建带聚合计数的树结构（内存中递归）

// 转为 id → model 映射，便于快速查找
$categoryMap = $categories->pluck('id')->flip()->mapWithKeys(function ($id) use ($categories) {
    return [$id => $categories->firstWhere('id', $id)];
});

// 初始化根节点集合
$roots = $categories->whereNull('parent_id')->values();

// 递归构建树并累加子计数
function buildTreeWithAggregatedCounts($nodes, $categoryMap): Collection {
    return $nodes->map(function ($node) use ($categoryMap) {
        // 获取直接子节点
        $children = $categoryMap->filter(fn($cat) => $cat->parent_id === $node->id);

        // 递归构建子树
        $node->children = buildTreeWithAggregatedCounts($children, $categoryMap);

        // 聚合计数：本级 + 所有后代的 posts_count / threads_count 总和
        $totalPosts = $node->posts_count + $node->children->sum('posts_count') 
                    + $node->children->sum(fn($child) => $child->children->sum('posts_count'));
        $totalThreads = $node->threads_count + $node->children->sum('threads_count')
                        + $node->children->sum(fn($child) => $child->children->sum('threads_count'));

        // 更健壮的递归累加（支持任意深度）
        $recursiveSum = function ($collection, $field) use (&$recursiveSum) {
            return $collection->sum($field) + $collection->sum(fn($item) => $recursiveSum($item->children ?? collect(), $field));
        };

        $node->all_posts_count = $recursiveSum(collect([$node]), 'posts_count');
        $node->all_threads_count = $recursiveSum(collect([$node]), 'threads_count');

        return $node;
    });
}

$treeWithTotals = buildTreeWithAggregatedCounts($roots, $categoryMap);

? 关键优化点：all_posts_count 和 all_threads_count 是包含自身及全部后代的总计数，适用于前端展示“该分类及其子分类共含 X 篇帖子”。

Laravel Cloud
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。

下载

3. 序列化为 JSON（可选：隐藏 children 或按需展开）

return response()->json($treeWithTotals->map(function ($cat) {
    return [
        'id' => $cat->id,
        'name' => $cat->name,
        'all_posts_count' => (int) $cat->all_posts_count,
        'all_threads_count' => (int) $cat->all_threads_count,
        // 仅需首层子类？则注释掉下一行；需完整树则保留
        'children' => $cat->children->map->only(['id', 'name', 'all_posts_count', 'all_threads_count']),
    ];
}));