Laravel调用search.customer路由提示缺少必填slug参数报错

DevOps 小满

2026-9-3

问题现象

页面持续返回错误提示：Missing required parameter，完整报错信息如下：

Missing required parameter for [Route: search.customer] [URI: agency/{slug}] [Missing parameter: slug]

现有代码

路由定义（routes/web.php）：

Route::get('/agency/{slug}', [SearchController::class, 'listing'])->name('search.customer');

Blade视图中的路由调用代码：

@if ($agents->isNotEmpty())
     @foreach ($agents as $value)
         <a href="{{ route('search.customer', ['slug'=>$value->agency_slug]) }}" class="btn btn-danger btn-sm btn_hover">View More</a>
     @endforeach
@endif

已在Blade视图中通过route()辅助函数为路由传入slug参数，但依然提示缺少必填路由参数，以下为可落地的排查思路和对应解决方案。

排查思路与解决方案

按优先级从高到低逐一验证即可：

优先清除Laravel缓存
路由、配置、视图缓存异常是这类问题最常见的诱因，直接在项目根目录执行以下命令清除所有相关缓存：
```
php artisan route:clear
php artisan config:clear
php artisan view:clear
```
执行完成后重新访问页面，若为缓存导致的问题此时会直接恢复正常。
校验传入的slug参数实际值
只要传入的slug值为null，哪怕代码里写了传参键，依然会触发缺少参数的报错。可以在循环内临时加字段打印，验证agency_slug是否存在空值：
```
@foreach ($agents as $value)
    {{-- 临时调试代码，验证完成后删除即可 --}}
    @if(is_null($value->agency_slug))
        @dd('存在空slug记录', $value)
    @endif
    <a href="{{ route('search.customer', ['slug'=>$value->agency_slug]) }}" class="btn btn-danger btn-sm btn_hover">View More</a>
@endforeach
```
如果调试时触发了dd输出，说明$agents集合中存在agency_slug字段为空的记录，对应解决方法：
1. 查询$agents数据时增加查询约束，过滤空值：->whereNotNull('agency_slug')；
2. 视图渲染时增加判空逻辑，slug为空的记录不输出跳转链接，或提前配置合法的默认跳转值。
排查页面其他位置的同路由调用
报错位置不一定是你贴出的循环代码，大概率是页面其他引入的组件（导航栏、侧边栏、页脚、公共挂件）中也调用了route('search.customer')，但没有传入slug参数。直接全局搜索项目内所有search.customer字符串，逐个核对调用时是否传全了必填参数即可。
核对参数名匹配规则
确认路由定义的参数名和传入的参数键完全一致，路由参数为{slug}时，传入的参数键必须是小写的slug，拼写错误、大小写不匹配都会导致参数识别失败。当前贴出的代码中参数键名是正确的，这一步仅在前述方案都无效时核对即可。

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

Laravel调用search.customer路由提示缺少必填slug参数报错

现有代码 #

现有代码