Laravel路由模型绑定通过路由参数名与控制器类型提示变量名严格匹配，自动注入模型实例；隐式绑定按id查找并404兜底，显式绑定支持slug等自定义字段及复杂逻辑。

Laravel 路由模型绑定不是“魔法”，而是基于命名约定与类型提示协同工作的机制。它让开发者跳过手动查库的重复劳动，把注意力集中在业务逻辑上。核心在于：Laravel 通过路由参数名匹配控制器方法中类型提示的变量名，自动完成模型实例注入——匹配成功则返回对应记录；不匹配或查无结果，直接抛出 404。

隐式绑定：最常用、最省心的写法

只要路由参数名和控制器参数变量名完全一致，Laravel 就会自动按主键（id）查找对应模型。不需要额外配置，也不用写 findOrFail()。

• 路由定义：Route::get('/posts/{post}', [PostController::class, 'show']);
• 控制器方法：public function show(Post $post) { ... }
• URL 示例：/posts/123 → 自动查出 id=123 的 Post 实例
• 若数据库中不存在该 id，直接返回 404，无需 try-catch

显式绑定：应对非标准字段或复杂逻辑

当你要用 slug、code 或其他字段做路由参数，或者需要加入权限校验、软删除过滤等逻辑时，就得用显式绑定。

Laravel Cloud

Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。

下载

• 在 RouteServiceProvider::boot() 中注册：
• Route::model('post', Post::class); —— 等价于默认隐式行为
• Route::bind('slug', function ($value) { return Post::where('slug', $value)->firstOrFail(); });
• 然后路由写成：Route::get('/posts/{slug}', [...]);，控制器接收 Post $slug 即可

常见陷阱：参数名不一致导致绑定失效

这是新手最容易踩的坑。Laravel 不看类名，只认变量名是否和路由参数名一致。

• 错误写法：Route::get('/reviews/{jobseekerExamReview:id}', [...]); + showResults(JobseekerExamReview $jobseeker)
• 问题：路由参数是 {jobseekerExamReview}，但变量名是 $jobseeker → 匹配失败
• 结果：Laravel 不执行模型绑定，而是走普通依赖注入，得到一个空模型实例
• 修复方式：统一为 $jobseekerExamReview，或改用显式绑定并明确指定参数名

API 路由同样适用，只是返回格式不同

在 routes/api.php 中使用模型绑定，逻辑完全一样，区别只在控制器返回值：

• Web 路由返回视图：return view('posts.show', compact('post'));
• API 路由返回 JSON：return response()->json($post);
• 中间件、命名、分组等所有路由特性都通用