Laravel中BookInfo模型type方法返回关系实例报错的解决方案

我正在开发一个图书馆应用（这是我的第一个Laravel项目，仅用于学习，请多包涵），每个Book对应一个BookInfo，BookInfo关联一个表示“fiction”或“non-fiction”的BookType。

表结构信息 #

BookInfo表结构：

//...
$table->unsignedBigInteger('book_id');
$table->unsignedBigInteger('book_type_id');

//...
$table->foreign('book_id')->references('id')->on('books');
$table->foreign('book_type_id')->references('id')->on('book_type');

BookType表结构：

//...
$table->id();
$table->string('name');

当前错误写法及报错 #

我尝试的写法如下，多次调整仍报错：

public function type()
{
    return BookType::where('book_type_id', $this->book_type_id)->get()->first();
}

报错信息：

"BookInfo::type must return a relationship instance but null was returned"

已确认book_type表中存在对应的id，最终需要获取BookType的name字段。

正确解法 #

Laravel Eloquent提供了专门的关联方法处理这类外键关联，你需要用belongsTo关系定义关联：

// 在BookInfo模型中
use App\Models\BookType; // 确保引入BookType模型

public function type()
{
    // 外键book_type_id对应BookType的主键id，符合默认规则，可简化写法
    return $this->belongsTo(BookType::class, 'book_type_id', 'id');
    // 因命名完全符合Laravel规范，也可进一步简化：
    // return $this->belongsTo(BookType::class);
}

使用方式 #

定义好关联后，即可通过以下方式获取BookType的name字段：

// 单个BookInfo实例
$bookTypeName = $bookInfo->type->name;

// 预加载关联避免N+1查询问题
$bookInfos = BookInfo::with('type')->get();
foreach ($bookInfos as $info) {
    echo $info->type->name;
}

错误原因说明 #

你之前的写法直接返回了查询结果（模型实例或null），但Laravel要求关联方法必须返回关联关系实例（如BelongsTo对象），而非直接执行查询后的结果。belongsTo方法会返回正确的关系实例，Laravel会在你访问关联属性时自动执行查询。

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