Laravel hasMany关联查询无法获取子页面完整字段问题

你当前定义的relation()关联直接将PageRelation中间表模型作为关联目标，预加载时只会查询page_relations表的记录，自然无法获取子页面在pages表中的title、description等完整字段。

方案1：调整关联定义，直接绑定子页面模型（推荐） #

page_relations是存储页面父子关系的中间表，直接在Page模型中通过中间表定义自关联的多对多关联，即可直接拿到完整的子页面模型数据：

1. 修改Page模型中的关联方法，建议将方法名改为语义化的children表示子页面，关联目标直接指向Page模型，通过page_relations中间表做映射：

// app/Models/Page.php
public function children()
{
    return $this->belongsToMany(
        Page::class,
        'page_relations', // 中间表名
        'parent_id', // 中间表中关联当前父页面ID的字段
        'page_id' // 中间表中关联子页面ID的字段
    );
}

// 如需反向查询页面的父页面，可以额外添加这个关联
public function parent()
{
    return $this->belongsToMany(
        Page::class,
        'page_relations',
        'page_id', // 中间表中关联当前子页面ID的字段
        'parent_id' // 中间表中关联父页面ID的字段
    );
}

2. 调整控制器中的预加载逻辑，改为加载新定义的children关联：

// 控制器中查询代码
$pages = Page::with('children')->get();

修改后直接遍历结果即可拿到子页面完整字段：

foreach ($pages as $page) {
    // 直接取子页面的标题、描述等任意pages表字段
    foreach ($page->children as $childPage) {
        echo $childPage->title;
        echo $childPage->description;
    }
}

如果你需要同时获取page_relations中间表的字段，可以在关联定义后链式调用withPivot()方法，例如要拿中间表的id：return $this->belongsToMany(...)->withPivot('id');，取的时候用$childPage->pivot->id即可。

方案2：保留原有中间表关联，用嵌套预加载（不推荐） #

如果不想修改原有relation关联定义，可以先在PageRelation模型中定义关联子页面的方法，再通过嵌套预加载拿数据：

1. 在PageRelation模型中添加关联到Page的方法：

// app/Models/PageRelation.php
public function childPage()
{
    return $this->belongsTo(Page::class, 'page_id');
}

2. 控制器中使用嵌套预加载：

$pages = Page::with('relation.childPage')->get();

这种方式取子页面字段需要多一层嵌套，写法繁琐：

foreach ($pages as $page) {
    foreach ($page->relation as $relation) {
        // 子页面数据在relation的childPage属性下
        echo $relation->childPage->title;
    }
}

• 建议遵循Laravel命名规范，将模型名从Pages改为单数形式Page，和表名pages的映射关系更清晰，减少不必要的配置。
• 如果业务逻辑中一个子页面只能归属一个父页面，后续可以考虑去掉page_relations中间表，直接在pages表加parent_id字段，用普通的自关联hasMany/belongsTo实现，查询性能更好。

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