在 Laravel 9.x 中实现无限级分类时，应添加 level 字段并配合观察者自动维护，以提升查询性能、简化树形渲染与权限控制；需通过迁移新增字段、用 Observer 动态计算层级、批量初始化历史数据，并支持按层级高效查询。
在 Laravel 9.x 中实现无限级分类时，单纯依赖 parent_id 递归查询效率低、嵌套深时易出错。增加 level 字段（表示当前节点所在层级，根节点为 0 或 1）能显著提升查询性能，便于前端渲染树形结构、限制最大深度、做权限控制等。
一、数据库字段设计与迁移
在分类数据表（如 categories）中添加 level 列，类型建议为 TINYINT UNSIGNED（支持 0–255 层，足够日常使用）：
php artisan make:migration add_level_to_categories_table
在迁移文件中：
public function up(MigrationBuilder $migration): void
{
$migration->table('categories', function (Blueprint $table) {
$table->tinyInteger('level')->unsigned()->default(0)->after('parent_id');
$table->index('level'); // 可选，按层级查询时加速
});
}二、模型中自动维护 level 值
不推荐手动设置 level，应通过模型事件或重写保存逻辑，在创建/移动节点时自动计算并更新。推荐使用 观察者（Observer） 方式：
- 创建观察者：
php artisan make:observer CategoryObserver --model=Category - 监听
creating和updating事件，根据 parent_id 推算 level - 若父节点存在，新节点 level = 父节点 level + 1；否则为 0（根节点）
示例逻辑（在 CategoryObserver 中）：
public function creating(Category $category): void
{
if ($category->parent_id) {
$parent = Category::find($category->parent_id);
$category->level = $parent ? $parent->level + 1 : 0;
} else {
$category->level = 0;
}
}
<p>public function updating(Category $category): void
{
// 若 parent_id 发生变更，需重新计算 level 并更新子树
if ($category->isDirty('parent_id')) {
$oldParentId = $category->getOriginal('parent_id');
$newParentId = $category->parent_id;</p><pre class='brush:php;toolbar:false;'> // 获取新父节点 level
$newParentLevel = 0;
if ($newParentId) {
$newParent = Category::find($newParentId);
$newParentLevel = $newParent ? $newParent->level + 1 : 0;
}
$category->level = $newParentLevel;
// 同时更新整个子树的 level（关键！）
$this->updateSubtreeLevel($category->id, $newParentLevel + 1);
}}
protected function updateSubtreeLevel(int $rootId, int $startLevel): void { $ids = Category::where('id', $rootId) ->withDepth() ->descendantsAndSelf() ->pluck('id') ->toArray();
if (!empty($ids)) {
Category::whereIn('id', $ids)->update(['level' => DB::raw("level - {$startLevel} + {$startLevel}")]);
// 更稳妥做法：用递归或闭包表思路批量更新，此处简化为逐层偏移
// 实际建议用「自定义递归更新」或「临时表+JOIN」方式确保原子性
}}
三、批量初始化已有数据的 level
如果表中已有历史数据，需一次性补全 level 值。可用 Artisan 命令或 Tinker 批量处理：
- 根节点（
parent_id = null或0）设为 level = 0 - 逐层 BFS 或递归更新子节点 level
简单安全的命令示例（放入 app/Console/Commands/InitCategoryLevel.php）：
public function handle(): int
{
// 先清空所有 level
Category::query()->update(['level' => 0]);
<pre class='brush:php;toolbar:false;'>// 根节点
Category::whereNull('parent_id')->orWhere('parent_id', 0)->update(['level' => 0]);
// 迭代更新多层（最多 10 层防死循环）
for ($level = 1; $level <= 10; $level++) {
$updated = Category::where('level', $level - 1)
->join('categories as p', 'categories.parent_id', '=', 'p.id')
->where('p.level', $level - 1)
->update(['categories.level' => $level]);
if (!$updated) break;
}
$this->info('Category level initialized.');
return self::SUCCESS;}
四、查询与使用示例
有了 level 字段后，可高效实现：
-
获取指定层级的所有分类：
Category::where('level', 2)->get() -
限制只查前两层：
Category::where('level', 'get() -
配合 parent_id 渲染带缩进的菜单（Blade 中）：
<div style="margin-left: {{ $category->level * 20 }}px">{{ $category->name }}</div> -
校验是否超最大层级（如最多 4 级）：
if ($request->level > 4) abort(400, 'Too deep')
注意：level 是冗余字段，务必确保其与 parent_id 严格一致，所有增删改操作都需同步维护，否则会导致树结构错乱。
