Laravel搜索功能返回全部数据库数据而非匹配结果该如何解决？

问题根因 #

• 表单输入框未设置name="search"属性，提交请求时没有携带搜索参数，控制器获取到的搜索关键词为null，执行的查询条件实际为LIKE '%%'，会匹配所有非空记录，因此返回全表数据。
• 控制器搜索逻辑未对空关键词做拦截处理，即便没有有效搜索参数也会执行全表查询。

修复步骤 #

1. 修改搜索表单 #

为搜索输入框添加name属性，确保搜索关键词能正常提交到后端：

<form class="form-inline my-2 my-md-0" action="/search" method="GET">
    <input class="form-control" type="text" name="search" placeholder="Search">
</form>

2. 优化控制器搜索逻辑 #

添加空关键词判断，避免无参数时触发全表查询：

public function search(Request $request){
    $searching = $request->input('search');

    $search = MusicUpload::query()
        // 仅当存在有效搜索关键词时执行匹配查询
        ->when($searching, function ($query, $searching) {
            return $query->where('filename', 'LIKE', "%{$searching}%")
                ->orWhere('artistname', 'LIKE', "%{$searching}%")
                ->orWhere('albumname', 'LIKE', "%{$searching}%");
        }, function ($query) {
            // 无搜索关键词时直接返回空结果
            return $query->whereRaw('1 = 0');
        })
        ->get();
    
    return view('pages.search', compact('search'));
}

如果需要对搜索输入做合法性校验，可以添加验证规则：

public function search(Request $request){
    $request->validate([
        'search' => 'required|string|min:1|max:50'
    ]);
    $searching = $request->input('search');

    $search = MusicUpload::query()
        ->where('filename', 'LIKE', "%{$searching}%")
        ->orWhere('artistname', 'LIKE', "%{$searching}%")
        ->orWhere('albumname', 'LIKE', "%{$searching}%")
        ->get();
    
    return view('pages.search', compact('search'));
}

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