Laravel调用同表子分类关联方法childCategories报错如何解决

你遇到的报错和关联失效来自两个核心错误：

• 关联定义不符合Eloquent规范：你写的关联方法没有调用框架提供的hasMany()方法返回标准关联实例，而是直接手动拼接where条件，既无法被框架识别为合法的模型关联，静态调用时还会因为模型实例不存在，$this->id取空值导致查询逻辑完全失效。
• 关联调用方式错误：模型关联是实例方法，不能通过Category::开头的静态查询构造器直接调用，静态调用时框架会定位到Illuminate\Database\Eloquent\Builder类，找不到你在模型里定义的childCategories方法，就会抛出你看到的Call to undefined method错误。

第一步：修正模型关联定义 #

在Category模型中重写关联方法，使用框架自带的一对多关联语法声明自引用关联：

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\HasMany;

class Category extends Model
{
    // 一级直接子分类关联
    public function childCategories(): HasMany
    {
        // 参数依次为：关联模型类名、外键字段名、当前模型关联字段名
        return $this->hasMany(Category::class, 'parent_id', 'id');
    }

    // 可选：递归获取所有层级的嵌套子分类
    public function nestedChildCategories(): HasMany
    {
        return $this->hasMany(Category::class, 'parent_id', 'id')
            ->with('nestedChildCategories');
    }
}

第二步：按场景正确调用关联 #

场景1：获取单个分类的子分类 #

先拿到对应分类的实例，再通过实例调用关联方法：

// 获取id为1的分类实例
$category = Category::find(1);
// 查询该分类下的所有直接子分类
$childList = $category->childCategories()->get();

场景2：获取全部分类并预加载对应子分类 #

通过with()方法预加载关联，避免N+1查询问题：

// 先查询所有顶级分类（假设顶级分类parent_id为0，可根据表实际值调整），同时预加载子分类
$categoryList = Category::where('parent_id', 0)
    ->with('childCategories')
    // 如果需要加载所有层级的嵌套子分类，替换为下面的预加载语句
    // ->with('nestedChildCategories')
    ->get();

遍历数据时直接通过关联属性取子分类即可：

foreach ($categoryList as $cate) {
    echo "顶级分类：" . $cate->title;
    foreach ($cate->childCategories as $child) {
        echo "子分类：" . $child->title;
    }
}

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