
本文详解如何在 Laravel 中正确配置模型以支持 slug 路由绑定与查询,解决因混淆 getRouteKeyName()、find() 行为及原生 DB 查询导致的 Attempt to read property "id" on null 错误。
本文详解如何在 laravel 中正确配置模型以支持 slug 路由绑定与查询,解决因混淆 `getroutekeyname()`、`find()` 行为及原生 db 查询导致的 `attempt to read property "id" on null` 错误。
在 Laravel 中,getRouteKeyName() 方法仅在启用隐式或显式路由模型绑定时生效,它不会影响 DB::table() 查询或 Model::find() 的底层行为。你当前的代码存在三个关键问题:
- 路由未启用模型绑定:Route::get('/{id}', [...]) 中的 {id} 是普通字符串参数,并非绑定到 Header 模型的占位符;
- 混用原生查询与 Eloquent:DB::table('headers')->find($id) 完全绕过 Header 模型,因此 getRouteKeyName() 和模型关系全部失效;
- find() 默认按主键(通常是 id)查找:即使设置了 getRouteKeyName('slug'),Header::find($slug) 仍会查 id 字段,除非你显式指定主键列。
✅ 正确做法是统一使用 Eloquent,并明确配置模型主键与关系:
// app/Models/Header.php
<?php namespace App\Models;
use Illuminate\Database\Eloquent\Model;
class Header extends Model
{
use \Illuminate\Database\Eloquent\Factories\HasFactory;
// 关键:将主键设为 'slug',使 Header::find($slug) 按 slug 字段查询
protected $primaryKey = 'slug';
// 可选:仅当启用路由模型绑定时才需要(如 Route::get('/{header:slug}', ...))
public function getRouteKeyName()
{
return 'slug';
}
// 推荐:定义 Eloquent 关系,替代手动 DB 查询
public function blocks()
{
return $this->hasMany(Block::class, 'header_id');
}
}
控制器应改用 Eloquent 实例化模型,并利用关系自动加载关联数据:
// app/Http/Controllers/MainController.php
public function show($id)
{
// ✅ 使用 Header 模型查找(按 slug 字段,因 $primaryKey = 'slug')
$header = Header::find($id);
// ❌ 不再使用 DB::table(...) —— 失去模型逻辑与关系能力
// $blocks = DB::table('blocks')->where('header_id', $id)->get();
// ✅ 利用预定义关系获取 blocks,更安全、可读性更强
$blocks = $header ? $header->blocks : collect();
return view('test', compact('header', 'blocks'));
}
⚠️ 注意事项:
Laravel Cloud(cloud.laravel.com)。此技能用于处理所有 Laravel Cloud 请求,包括搜索和读取数据。只要任务涉及 Laravel Cloud,即使用此技能。
- 若你希望保留 /slug-value 这样的语义化 URL 并启用自动绑定,应更新路由为:
Route::get('/{header:slug}', [MainController::class, 'show'])->name('show');此时 Laravel 会自动注入 Header 实例(基于 slug 字段),控制器方法签名也需改为 public function show(Header $header)。
- protected $primaryKey = 'slug' 意味着该模型不再使用 id 作为主键,所有 find()、findOrFail()、delete() 等操作均作用于 slug 字段,请确保数据库中 slug 唯一且非空。
- 若 slug 并非主键(即表仍有 id 主键,slug 仅为唯一索引),则不应设置 $primaryKey = 'slug',而应改用 Header::where('slug', $id)->first(),并配合 getRouteKeyName() + 路由绑定。
总结:getRouteKeyName() 服务于路由绑定机制,find() 行为由 $primaryKey 决定,二者不可混为一谈。坚持使用 Eloquent 模型、明确定义主键与关系,才能写出健壮、可维护的 Laravel 代码。










