当 laravel 遇到非默认主键或路由参数并非模型主键时，其隐式模型绑定机制可能导致 `notfoundhttpexception`。本文将详细讲解如何正确配置模型，以及在控制器中通过手动查询而非隐式绑定来处理这类情况，确保数据能够被正确检索和显示。同时，文章也将强调数据库命名规范的重要性，以避免潜在的问题。
理解 Laravel 的隐式模型绑定
Laravel 提供了强大的隐式模型绑定功能，它允许你在控制器方法签名中类型提示一个 Eloquent 模型，Laravel 会自动根据路由参数的值在数据库中查找对应的模型实例并注入。默认情况下，Laravel 会尝试使用路由参数的值来查询模型的主键（通常是 id 列）。例如，如果你的路由是 /users/{user}，并且控制器方法是 show(User $user)，Laravel 会尝试执行 User::find($user_id_from_route)。
自定义主键与路由参数的冲突
当你的模型使用了自定义主键（例如 user-info-id 而非 id），或者路由参数所代表的并非模型的主键，而是表中的另一个唯一字段（例如 user-id），那么 Laravel 的默认隐式模型绑定就会出现问题。
在提供的场景中，模型 usersinformation 定义了 $primaryKey = 'user-info-id'，但控制器方法 show(usersinformation $usersinformation) 接收的路由参数很可能是一个名为 user-id 的值。此时，Laravel 的隐式绑定会尝试使用这个 user-id 的值去查询 user-info-id 字段，这显然会导致查询失败，从而抛出 NotFoundHttpException。
解决方案：手动查询与数据传递
解决此问题的最直接方法是放弃隐式模型绑定，转而手动在控制器中根据路由参数进行查询。这允许你明确指定用于查询的字段。
修改控制器方法签名： 将控制器方法签名中的模型类型提示移除，改为接收一个普通的变量，该变量将代表路由中传递的参数。
手动执行 Eloquent 查询： 在控制器方法内部，使用 Eloquent 的 where 方法根据你希望查询的字段（例如 user-id）来查找模型实例。
将查询结果传递给视图： 确保将查询到的模型实例作为数据传递给视图，以便在视图中进行渲染。
以下是修正后的控制器代码示例：
first();
// 如果没有找到用户，可以抛出404或重定向
if (!$user_information) {
abort(404, 'User information not found.');
}
// 将查询到的用户信息传递给视图
return view('usersinformation.show', ['userinformation' => $user_information]);
}
}路由配置： 为了使上述控制器方法能够正确接收 $user_id 参数，你的路由定义也需要进行相应的调整，以匹配动态参数。例如，如果你的路由希望通过 user-id 来显示信息，路由应定义为：
// web.php
Route::get('/usersinformation/{user_id}', [App\Http\Controllers\usersinformationController::class, 'show'])->name('usersinformation.show');请注意，这里将路由方法从 post 改为 get，因为显示数据通常是 GET 请求。如果你确实需要使用 POST 请求来显示数据，请确保你的表单或 AJAX 请求方法是 POST。
模型配置的注意事项
在模型中设置自定义主键和非自增主键是正确的做法：
class usersinformation extends Model
{
public $table = "usersinformation";
public $incrementing = false; // 如果主键不是自增的，务必设置为 false
protected $fillable = [
'fname','lname', 'user-picture', 'phone-number', 'user-id', 'place-id'
];
protected $primaryKey = 'user-info-id'; // 明确指定自定义主键
public function users(){
return $this->belongsTo('App\users'); // 修正了 belongsTo 的返回
}
}$primaryKey = 'user-info-id' 告诉 Eloquent 该模型的主键是 user-info-id，而非默认的 id。$incrementing = false 则表明该主键不是自增的。这些配置对于模型与数据库的正确交互至关重要。
数据库命名规范建议
强烈建议避免在数据库表名和列名中使用连字符（-）。连字符在 SQL 查询、ORM 操作以及其他编程语言（如 JavaScript）中可能导致语法错误或混淆。
推荐使用下划线（_）作为分隔符。 例如：
- 将 user-info-id 改为 user_info_id。
- 将 user-id 改为 user_id。
- 将 phone-number 改为 phone_number。
- 将 user-picture 改为 user_picture。
遵循这样的命名规范可以显著提高代码的可读性、可维护性，并避免潜在的运行时问题。
总结
当 Laravel 的隐式模型绑定与你的自定义主键或路由参数不匹配时，最稳妥的解决方案是采取手动查询的方式。通过在控制器中明确使用 where 条件进行查询，你可以精确控制数据检索逻辑。同时，始终遵循良好的数据库命名规范，例如使用下划线代替连字符，将有助于构建更健壮、更易于维护的应用程序。
