重写 getRouteKeyName() 是 Laravel 隐式模型绑定中切换查询字段最轻量、最推荐的方式，但需同时满足路由参数名与控制器参数名一致、模型类型提示正确、模型位于 App\Models 命名空间三个条件才生效；其返回值须为纯字符串字段名且对应字段需加唯一索引；软删除数据默认仍会匹配，需重写 resolveRouteBinding() 或使用全局作用域排除；多段 URL 路由不适用此方式，应手动组合查询。
重写 getRouteKeyName() 是 Laravel 隐式模型绑定中切换查询字段最轻量、最推荐的方式，但它只在隐式绑定真正触发时才生效——不是写了就起作用，得先确保绑定机制被正确激活。
触发隐式绑定的三个硬性条件
这个方法不会自动运行，必须同时满足：
- 路由参数名和控制器参数名完全一致（小写单数，如
{post}→$post） - 控制器方法中对该参数做了明确的模型类型提示（
Post $post，不能是$post或object $post） - 模型类位于
App\Models命名空间，且类型提示路径正确（要么用use引入，要么写全路径）
getRouteKeyName() 的写法规范
它必须返回一个纯字符串字段名，不能带逻辑或条件判断：
- ✅ 正确：
return 'slug';、return 'username'; - ❌ 错误：
return $this->is_admin ? 'id' : 'slug';、return 'slug IS NOT NULL'; - 数据库对应字段需加唯一索引，否则高并发下查询可能严重变慢
- 若主键是 UUID，还需在模型中声明：
protected $primaryKey = 'uuid';和public $keyType = 'string';
软删除场景下的注意事项
默认情况下，getRouteKeyName() 不会影响软删除行为——已删除记录仍会被查出来：
- 如果希望排除软删除数据，应在模型中重写
resolveRouteBinding()方法，手动添加->withoutTrashed() - 或者，在全局作用域中统一处理，避免每个绑定都重复判断
- 不要依赖
Route::model()，它绕过getRouteKeyName()，硬编码走主键查询
多段 URL 或复合标识不适用此方式
像 /posts/2024/05/hello 这类含年月 slug 的路由，{post} 占位符无法自动拆解三段值：
-
getRouteKeyName()对这种结构完全无效 - 强行塞进一个占位符（如
{post}接收"2024-05-hello"）会破坏语义，增加维护成本 - 更合理的是放弃绑定，在控制器中组合查询：
Post::whereYear('published_at', $year)->whereMonth('published_at', $month)->where('slug', $slug)->firstOrFail()
