Laravel 本身不支持限制父子关联深度的原生语法，也没有内置 withDepth() 方法；所谓“深度限制”必须通过手动控制查询层级、MySQL 8.0+ CTE 递归查询、添加 level 字段配合 where 条件，或 PHP 层递归预加载实现。
直接说结论：Laravel 本身不支持“限制父子关联深度”这种树形结构的原生语法，也没有类似 withDepth() 这样的内置方法；所谓“深度限制”，必须靠手动控制查询层级、或借助数据库特性（如 MySQL 8.0+ CTE）、或用内存递归 + 预加载 + 层级字段来实现。
为什么 with() 不能限制关联深度
很多人误以为在 with() 里嵌套多层就能“自动限制深度”，比如：
Category::with(['children.children.children'])->get();
这只会预加载最多 3 级子分类，但不会过滤掉第 4 级及更深的记录——它只是不加载它们。如果你查的是根节点，而数据库里实际有 5 级，你拿到的数据结构里依然可能包含第 4、5 级（取决于模型关系定义是否递归），只是没被 eager loaded 而已。更关键的是：with() 不影响主查询范围，也不做层级裁剪。
- 它不阻止数据库返回深层数据（如果用了
whereHas()或其他条件，逻辑可能意外穿透） - 它无法表达“只取前 N 层”的语义，纯属加载控制，不是查询约束
- 对无限级关系（如评论回复链），硬写
with(['replies.replies.replies'])极其脆弱且不可维护
MySQL 8.0+ 用 WITH RECURSIVE 实现真·深度限制
这是最可靠、性能最好、真正由数据库执行“深度裁剪”的方式。例如，只查用户 ID=5 的2 级以内直系下属（含自己）：
WITH RECURSIVE user_tree AS ( SELECT id, name, parent_id, 0 AS depth FROM users WHERE id = 5 UNION ALL SELECT u.id, u.name, u.parent_id, ut.depth + 1 FROM users u INNER JOIN user_tree ut ON u.parent_id = ut.id WHERE ut.depth < 2 ) SELECT * FROM user_tree;
注意关键点：
ut.depth 是深度闸门，<strong>数据库层面就截断了第 3 层及以后的递归</strong>- 结果集天然不含超深节点，PHP 层无需再过滤
- 必须用
DB::select()调用，不能走 Eloquent 模型（除非封装成 scope 或自定义 builder） - MySQL 版本必须 ≥ 8.0；低版本只能退到 PHP 层递归
用 level 字段 + where 条件模拟深度控制
如果无法升级数据库，又想避免全量加载再 PHP 过滤，推荐在表中加一个 level 字段（整数），并在插入/移动节点时维护它（例如根为 0，子为 1，孙为 2）。然后直接用 where 查询：
Category::where('level', '<=', 2)->get();
或者结合关系预加载：
Category::where('parent_id', $rootId)
->with(['children' => function ($q) {
$q->where('level', '<=', 3); // 从根起算，最多到第 3 层
}])
->get();
这种方式简单、可索引、Eloquent 友好，但代价是写操作变重，需确保 level 始终准确——比如拖动节点时漏更新，数据就错乱了。
PHP 层递归 + 一次查询（兼容所有数据库）
适合中小数据量、MySQL parent_id 归组，再用递归函数按 depth 截断：
$allNodes = Category::whereIn('id', $seedIds)->get()->keyBy('id');
$tree = buildTree($allNodes, $rootId, $maxDepth = 2);
<p>function buildTree($nodes, $parentId, $maxDepth, $depth = 0) {
if ($depth > $maxDepth) return [];
return $nodes->filter(fn($n) => $n->parent_id == $parentId)
->map(function ($node) use ($nodes, $maxDepth, $depth) {
return $node->merge(['children' => buildTree($nodes, $node->id, $maxDepth, $depth + 1)]);
});
}
优点是完全可控、不依赖 DB 特性；缺点是内存占用随树宽增大而上升，且无法利用数据库索引加速层级筛选。
真正容易被忽略的点是：深度限制从来不是单点技术问题，而是“查询语义 + 数据建模 + 维护成本”的权衡。CTE 最干净但要 DB 升级；level 字段最省心但写逻辑要加固；PHP 递归最灵活但得盯内存。选哪个，取决于你当前的数据库能力、数据规模、和团队对一致性的容忍度。
