Laravel路由模型绑定自定义键失效问题求助

你的路由写法本身是正确的——Laravel支持在单个路由中指定自定义绑定字段，无需全局修改getRouteKeyName()方法。出现查询无结果的错误，大概率是以下常见问题导致，你可以逐一排查：

• 核对数据库username字段的实际值：确认目标记录的username字段确实是user-349，注意大小写、前后空格这类细节（比如数据库存的是User-349或user-349 带末尾空格，都会导致匹配失败）。
• 清理路由缓存：如果之前执行过php artisan route:cache，新的路由规则不会生效。运行php artisan route:clear清空缓存后再测试。
• 排查路由冲突：检查路由文件中是否在这条路由之前定义了类似Route::get('/profiles/{userProfile}', ...)的规则。Laravel会优先匹配先定义的路由，导致你的自定义字段规则被跳过。把这条带username绑定的路由移到所有同类路由的前面。
• 检查软删除与全局查询作用域：如果UserProfile模型启用了SoftDeletes trait，确认目标记录没有被软删除；同时检查模型的booted()方法中是否添加了全局查询作用域，会不会过滤掉了这条记录。

如果以上排查都没解决问题，可以临时用手动查询测试定位问题：

Route::get('/profiles/{username}', function ($username) {
    dd(\App\Models\UserProfile::where('username', $username)->first());
});

访问{{base_url}}/profiles/user-349，如果能输出数据，说明是路由绑定的规则生效问题；如果仍返回null，则说明是查询条件或模型限制导致的无结果。

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