隐式绑定使用UUID必须重写getRouteKeyName()返回'uuid'，否则find()按整型主键查找必失败；需确保uuid字段有唯一索引，且模型声明$keyType='string'、$incrementing=false。
隐式绑定用 UUID 必须重写 getRouteKeyName()
默认隐式绑定只认 id 字段，哪怕你传的是 UUID 字符串，Laravel 仍会调用 User::find('abc123...')——而 find() 默认走主键且要求整型，必然失败，最终给你一个空字符串或报错。
正确做法是在模型里明确告诉框架：“别查 id，查 uuid 字段”：
class User extends Model
{
public function getRouteKeyName()
{
return 'uuid';
}
}
- 必须返回字段名字符串，不能是表达式或方法调用
- 该字段需有唯一索引，否则可能查出多个结果导致意外行为
- 软删除模型不会自动过滤，若要包含已删除记录，得在
resolveRouteBinding()里手动加withTrashed() - 路由写法保持不变：
Route::get('/users/{user}', ...)，参数名仍得是{user}，控制器类型提示仍是User $user
Route::bind() 绑定 UUID 更灵活但需手动处理 null
当你不想改模型、或需要额外逻辑（比如日志、fallback 到 guest 用户），Route::bind() 是更可控的选择。它绕过 getRouteKeyName()，完全由你定义查询逻辑。
注册位置必须是 app/Providers/RouteServiceProvider.php 的 boot() 方法内：
Route::bind('user', function ($value) {
return \App\Models\User::where('uuid', $value)->first();
});
- 控制器参数必须加
?类型提示：function (?User $user)，否则 PHP 会在绑定后立即抛TypeError - 用
first()而非firstOrFail()，才能拿到null做后续判断 - 想最终返回 404？在控制器里补一句
if (! $user) { abort(404); }，这样你能插日志、埋点、甚至 fallback 到缓存用户 - 别在闭包里直接
abort(404)，那会跳过控制器和中间件，响应格式也不受 Laravel 统一控制
Route::model() 不适合 UUID 场景
Route::model('user', User::class) 是语法糖，底层仍调用 find($value)，不支持自定义字段。即使你改了 getRouteKeyName()，它也**不生效**——Route::model() 完全忽略该方法，硬编码走主键查找。
- 它只适用于主键为整型
id的场景，UUID、slug、username 都不行 - 试图传回调函数给
Route::model()（如文档误传）会报Too few arguments错误 - 真要用 UUID，要么走
getRouteKeyName()+ 隐式绑定，要么走Route::bind()，别在这儿绕弯
UUID 字段值被截断或解析失败的常见原因
即使绑定逻辑写对了，请求仍 404，大概率是值在传输中被破坏或匹配不上：
- URL 中的 UUID 包含大写字母或短横线（如
ABC123-...），但数据库字段是小写存储，且没做strtolower()处理 - 路由约束缺失，导致非法字符进入绑定逻辑，例如
{user}没加where('user', '[a-f0-9\-]+')，Nginx 或浏览器可能把%编码搞乱 - 模型的
$keyType = 'string'没显式声明，Laravel 可能尝试 cast 成 int，造成静默转换失败 - 使用了 API 路由组但忘了加
->middleware('bindings')（虽然 Laravel 10+ 默认启用，但自定义内核或中间件顺序错位时可能失效）
最稳的调试方式：在 Route::bind() 回调开头加 Log::debug('UUID received:', ['value' => $value]);，确认进来的值和数据库存的一致。
