Laravel预加载关联模型时如何获取指定字段并输出扁平化结构

核心原因说明 #

你第三次尝试拿到author: null的根本原因是：Laravel 执行belongsTo类型的关联预加载时，必须选中关联表的主键（也就是这里authors表的Id字段），才能将查询到的作者数据和对应的书籍匹配，只查询Name字段无法完成关联匹配，自然拿不到数据。

而前两次尝试输出的是嵌套的作者对象，是因为你直接保留了author关联属性，没有做字段拍平处理。

前置检查 #

由于你提到数据库字段不遵循Laravel默认命名规范，需要先确认Book模型中已经正确定义author关联，示例如下（外键字段请替换为你实际表中的字段名）：

// App\Models\Book.php
public function author()
{
    // 参数依次为：关联模型类、books表中存作者ID的外键字段名、authors表的主键字段名
    return $this->belongsTo(Author::class, 'author_id', 'Id');
}

正确实现方案 #

方案1：预加载+结果处理（适合需要同时用到其他关联数据的场景） #

在原有基础上修改map逻辑，直接将author字段赋值为作者名称字符串即可：

return Book::with([
    'author' => function($query){
        // 必须带上authors表的Id字段完成关联匹配
        $query->select('Id', 'Name');
    }
])->get()->map(function ($book) {
    return [
        'Title' => $book->Title,
        'Version' => $book->Version,
        'author' => $book->author->Name
    ];
});

方案2：联表查询（性能更高，无需二次查询关联表） #

直接用join一次查询拿到所有需要的字段，不需要额外处理结果：

return Book::join('authors', 'books.author_id', '=', 'authors.Id')
    ->select('books.Title', 'books.Version', 'authors.Name as author')
    ->get();

两种方案最终输出的结构都和你期望的完全一致。

原尝试失败原因梳理 #

• 第一次尝试：未对关联的author对象做处理，直接返回了完整的关联模型数据
• 第二次尝试：限制了关联查询的字段，但仍然保留了author对象结构，没有拍平为字符串
• 第三次尝试：预加载时未带上authors表的Id字段，无法完成关联匹配，导致author为null

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