Laravel路由未绑定模型：请求返回空模型问题

问题现象 #

发起GET /api/users/123/info请求时，数据表中存在id为123的用户记录，路由未缓存，但路由模型绑定返回空User模型，同时URL中的123被作为额外参数传入闭包。

排查与解决步骤 #

1. 检查模型路由键配置 #

Laravel默认根据路由参数名匹配模型主键（默认id），如果模型自定义了路由键，会导致绑定失败：
打开User模型，查看是否存在以下自定义方法：

public function getRouteKeyName()
{
    return 'slug'; // 若返回非'id'字段，而URL传入的是id值，会返回空模型
}

如果有此方法，要么修改为返回'id'，要么URL传入对应字段的值。

2. 确认路由与闭包参数名一致 #

确保路由中的{user}和闭包的$user参数名完全匹配（大小写也要一致，Laravel绑定严格匹配参数名）。

3. 排查全局路由绑定规则 #

查看App\Providers\RouteServiceProvider的boot方法，是否存在全局绑定规则：

Route::model('user', User::class);

确认绑定的模型正确，且没有额外查询条件过滤掉id=123的记录。

4. 清理重复路由 #

你定义了三个相同的GET /users/{user}/info路由，Laravel只会匹配第一个定义的路由。绑定失败时，Laravel会将参数值作为额外参数传入闭包，这就是你看到[0 => User{...empty model...}, 1 => 123]的原因。删除重复路由，只保留需要的一条再测试。

5. 显式指定绑定规则（可选） #

如果需要明确绑定逻辑，可以在路由中强制指定：

// 限定参数为数字id，并强制用id字段绑定
Route::get('users/{user}/info', function(User $user) {
    dd($user);
})->where('user', '[0-9]+');

// 或自定义查询逻辑
Route::get('users/{user}/info', function(User $user) {
    dd($user);
})->bind('user', function($value) {
    return User::findOrFail($value);
});

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