Laravel Scout多字段搜索异常：组合姓名无结果，求解决方案

背景 #

User模型可填充字段：

protected $fillable = [
    'name',
    'email',
    'password',
    'birthday',
    'surname'
];

当前使用Laravel Scout搜索：

$matchingUsers = User::search($request->search)->get();

问题：单独搜索名字或姓氏结果正常，但同时输入名字+姓氏时无结果返回。

预期结果 #

数据库用户记录：

• id=>1 , name => "Neil", surname => "Armstrong"
• id=>2 , name => "Juan Manuel", surname = "Armstrong"

1. 搜索“Neil Armstrong”时返回id=1的用户；
2. 搜索“Juan Armstrong”时返回id=2的用户；
3. 搜索“Manuel”时返回id=2的用户。

已尝试方案 #

原生SQL可解决第一个场景，但不想混用原生SQL与Eloquent/Scout：

SELECT id, name, surname, image
FROM users
WHERE CONCAT(name,' ', surname) = "Neil Armstrong";

解决方案 #

方案1：仅使用Eloquent实现 #

方式A：关键词拆分匹配（推荐，覆盖所有场景）

拆分搜索关键词，每个词分别匹配name或surname，确保组合搜索时每个关键词都能命中对应字段：

$searchTerm = $request->search;
$terms = array_filter(explode(' ', $searchTerm)); // 过滤空字符串

$matchingUsers = User::query();

foreach ($terms as $term) {
    $matchingUsers->where(function ($query) use ($term) {
        $query->where('name', 'LIKE', "%{$term}%")
              ->orWhere('surname', 'LIKE', "%{$term}%");
    });
}

$users = $matchingUsers->get();

方式B：结合组合字段匹配

通过whereRaw生成组合字段匹配，同时保留单个字段的模糊搜索，兼顾精准匹配和模糊匹配：

$searchTerm = $request->search;

$users = User::whereRaw('CONCAT(name, " ", surname) LIKE ?', ["%{$searchTerm}%"])
             ->orWhere('name', 'LIKE', "%{$searchTerm}%")
             ->orWhere('surname', 'LIKE', "%{$searchTerm}%")
             ->get();

方案2：仅使用Laravel Scout实现 #

修改User模型的toSearchableArray方法，将姓名组合字段加入索引，让Scout能识别组合搜索关键词：

1. 更新User模型：

public function toSearchableArray()
{
    $array = $this->toArray();

    // 添加组合姓名字段到搜索索引
    $array['full_name'] = "{$this->name} {$this->surname}";

    return $array;
}

2. 重新生成搜索索引：

php artisan scout:import "App\Models\User"

完成后，原有的User::search($request->search)->get()即可支持所有预期场景的搜索——Scout会自动在name、surname和full_name字段中匹配关键词，不管是单个词还是组合词都能返回正确结果。

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