Laravel 5.6中getRouteKeyName()路由模型绑定失效问题

我之前也遇到过一模一样的情况，明明配置了getRouteKeyName但模型还是为空，大概率是这几个细节没处理好，你可以逐一排查：

1. 检查路由顺序是否正确 #

你的通配符路由/{uri}会匹配几乎所有GET请求，如果它放在了其他更具体的路由（比如/about、/contact）前面，那些具体路由永远不会被触发；如果请求的路径刚好没有对应的Page记录，就会返回空模型。

解决方法：把这个通配符路由放到routes/web.php的最后一行，确保所有具体路由都先被匹配：

// 先定义所有具体路由
Route::get('/about', 'AboutController@show');
Route::get('/contact', 'ContactController@show');

// 最后放通配符路由
Route::get('/{uri}', 'PageController@show')->name('page.show');

2. 确认路由参数能捕获完整的URI路径 #

默认情况下，Laravel的路由参数{uri}只会匹配不含斜杠的字符，如果你的Page模型的uri字段包含多级路径（比如blog/post-1），这个路由就无法正确捕获，导致查询不到对应记录。

解决方法：给路由参数添加正则约束，允许匹配斜杠：

Route::get('/{uri}', 'PageController@show')
    ->name('page.show')
    ->where('uri', '.*'); // 允许匹配任意字符（包括斜杠）

3. 清除路由缓存 #

如果你之前执行过php artisan route:cache，Laravel会生成路由的缓存文件，后续的路由或模型修改（比如自定义getRouteKeyName）不会生效，因为缓存的路由会直接绕过动态解析。

解决方法：执行命令清除路由缓存：

php artisan route:clear

之后再测试请求，应该就能正确解析模型了。

4. 验证数据库中的uri字段值 #

确保数据库里的uri字段值和你请求的路径完全一致，注意大小写、斜杠、空格这些细节：

• 比如你请求的是/about-us，但数据库里的uri是about-us（不带开头的斜杠），这时候查询会失败，因为路由捕获的uri是about-us，和数据库值不匹配。
• 可以在控制器里临时添加调试代码，看看捕获的uri是什么：

public function show($uri) {
    dd($uri); // 输出捕获的参数，对比数据库里的值
    $page = Page::where('uri', $uri)->first();
    return view('templates.page', compact('page'));
}

5. 检查模型是否有全局作用域 #

如果Page模型设置了全局作用域（比如只查询status = 1的记录），可能会导致即使uri匹配，也因为作用域过滤而查不到记录。

解决方法：可以临时在控制器里关闭全局作用域测试：

public function show(Page $page) {
    $page = Page::withoutGlobalScopes()->where('uri', request()->route('uri'))->first();
    dd($page); // 看看是否能查到记录
    return view('templates.page', compact('page'));
}

如果这样能查到，说明全局作用域是问题所在，你需要调整作用域逻辑，或者在路由模型绑定的时候排除该作用域。

内容的提问来源于stack exchange，提问作者Danny Guest