Route::model('user', User::class) 对 UUID 不生效，因 Laravel 默认按整数 id 查询，而 UUID 是字符串主键，需配置 $incrementing = false、$keyType = 'string'，或改用 Route::bind() 手动查询。
为什么 Route::model('user', User::class) 对 UUID 不生效
因为 Laravel 默认只按 id 字段查整数主键，而 UUID 是字符串，且通常不叫 id。即使你数据库字段名是 id，只要类型是 uuid 或 char(36)，Route::model 在 Laravel 9+ 中默认不会做字符串类型隐式转换，直接走 User::findOrFail($value)，但底层 SQL 会把传入的字符串当整数比对（尤其用 MySQL 时），结果查不到就 404。
- 确认模型里已设
$incrementing = false和$keyType = 'string' - 检查迁移中是否用了
$table->uuid('id')->primary()或等效定义（如char(36)） - 别依赖“字段叫 id 就能自动识别”——Laravel 不看字段类型，只看模型配置和查询逻辑
用 Route::bind() 手动按 UUID 查询
这是最可控、兼容性最好的方式，绕过 Route::model 的类型限制，自己写查询逻辑。
- 在
app/Providers/RouteServiceProvider.php的boot()方法里加：
Route::bind('user', function ($value) {
return App\Models\User::where('id', $value)->firstOrFail();
});
- 如果主键字段不是
id（比如叫uuid），就把where('id', $value)换成where('uuid', $value) - 确保
$value是标准格式（如550e8400-e29b-41d4-a716-446655440000），避免前端传入大小写混杂或带大括号的变体 - 不用
findOrFail()的话，得自己throw (new \Illuminate\Database\Eloquent\ModelNotFoundException())，否则绑定失败不会触发 404
隐式绑定 + getRouteKeyName() 配合 UUID
如果你坚持用类型提示（如 public function show(User $user)），就得让模型告诉 Laravel：“别查 id，查这个字段”。
- 在
User模型里加方法：
public function getRouteKeyName()
{
return 'id'; // 或 'uuid'，必须和数据库字段名完全一致
}
- 前提是该字段确实是主键，且
$incrementing = false已设置，否则 Eloquent 仍会尝试用整数逻辑查 - 这个方法只影响隐式绑定，对
Route::model()无效；Route::model()始终走find()，不调用getRouteKeyName() - 测试时注意：URL 中的值必须严格匹配数据库存储格式（比如全小写、无空格），MySQL 默认不区分大小写，但 PostgreSQL 会
路由参数约束要同步更新
UUID 字符串不能用 whereNumber()，否则路由根本不会匹配，直接跳过绑定逻辑。
- 错误写法：
Route::get('/users/{user}', ...)->whereNumber('user')→ 匹配失败，$user变成字符串原始值，绑定不触发 - 正确写法：
Route::get('/users/{user}', ...)->where('user', '[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}') - 更稳妥的是全局注册正则模式，在
RouteServiceProvider里加：Route::pattern('uuid', '[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}');，然后路由写{user}并->where('user', 'uuid')
