本文介绍在 laravel 8 中不使用 `whereraw` 的前提下，通过数据库原生全文索引（fulltext）对分散存储的 `first_name` 和 `last_name` 字段进行联合模糊搜索与按全名排序的高性能方案。
在实际开发中，当用户姓名被拆分为 first_name 和 last_name 两个独立字段时，常见的搜索需求（如输入“John Doe”匹配完整姓名）和排序需求（如 orderBy('full_name')）往往难以优雅实现——若强行拼接字符串或使用 whereRaw(CONCAT(...))，不仅破坏 Eloquent 的可移植性，更会在大数据量场景下引发严重性能瓶颈（如全表扫描、无法利用索引）。
推荐方案：MySQL FULLTEXT 索引 + Laravel 原生查询构造器
MySQL 的 FULLTEXT 索引专为文本搜索优化，支持自然语言模式（MATCH ... AGAINST），可跨多列建立联合索引，并自动处理词序、停用词与相关性排序。相比 LIKE '%term%' 或 CONCAT() 拼接，其查询速度提升可达数量级，且完全避免 whereRaw 的安全与维护风险。
✅ 第一步：为 first_name 和 last_name 添加联合 FULLTEXT 索引
在迁移文件中添加：
// php artisan make:migration add_fulltext_index_to_employees
public function up(MigrationBuilder $migration)
{
$migration->table('employees', function (Blueprint $table) {
$table->fullText(['first_name', 'last_name']);
});
}执行迁移后，MySQL 将创建一个覆盖两列的全文索引（注意：仅 InnoDB 表支持多列 FULLTEXT；MyISAM 已弃用）。
✅ 第二步：重构 scopeSearch，使用 MATCH ... AGAINST 替代 orWhere 链
public function scopeSearch($query, $term)
{
$term = trim($term);
if (empty($term)) {
return $query;
}
// 使用自然语言模式（默认），自动按相关性排序
$query->where(function ($q) use ($term) {
$q->where('type', 'LIKE', "%{$term}%")
->orWhere('name', 'LIKE', "%{$term}%")
->orWhereHas('level', fn($sub) => $sub->where('name', 'LIKE', "%{$term}%"))
->orWhereHas('employee', function ($sub) use ($term) {
// ✅ 关键替换：用 MATCH 对 first_name + last_name 联合搜索
$sub->whereRaw("MATCH(first_name, last_name) AGAINST(? IN NATURAL LANGUAGE MODE)", [$term]);
// 同时保留 employee_number 等其他字段的 LIKE 搜索
$sub->orWhere('employee_number', 'LIKE', "%{$term}%");
})
->orWhereHas('status', fn($sub) => $sub->where('name', 'LIKE', "%{$term}%"));
});
return $query;
}⚠️ 注意：MATCH ... AGAINST 在 NATURAL LANGUAGE MODE 下不支持通配符（如 *），但会智能匹配词干与近义词；若需精确前缀匹配（如“Joh”），可改用 BOOLEAN MODE 并配合 `+John +Doe*` 语法（需确保最小词长配置合理）。
✅ 第三步：实现按全名排序（无需虚拟列或 whereRaw）
由于 MySQL 不支持直接 ORDER BY CONCAT(first_name, ' ', last_name) 利用索引，但可通过 MATCH 的隐式相关性排序获得“语义上更匹配”的结果。若需严格字典序排序（如 A-Z 全名列表），建议：
-
方案 A（推荐）：添加生成列（Generated Column）并建索引（MySQL 5.7+）
ALTER TABLE employees ADD COLUMN full_name VARCHAR(255) GENERATED ALWAYS AS (CONCAT(TRIM(first_name), ' ', TRIM(last_name))) STORED, ADD INDEX idx_full_name (full_name);Laravel 中即可安全使用：
->orderBy('full_name', $this->order) -
方案 B（兼容性更强）：应用层排序（适用于分页数据量可控场景）
$models = Model::where('company_id', Auth::user()->company_id) ->search(trim($this->search)) ->paginate($this->size); // 对当前页结果按全名排序（注意：仅限小页码，避免内存溢出） $models->items()->sort(function ($a, $b) { $fullNameA = trim("{$a->employee->first_name} {$a->employee->last_name}"); $fullNameB = trim("{$b->employee->first_name} {$b->employee->last_name}"); return $this->order === 'desc' ? strcmp($fullNameB, $fullNameA) : strcmp($fullNameA, $fullNameB); });
? 关键总结
- ✅ FULLTEXT 是解决多字段联合模糊搜索的标准、高效、安全方案，远优于 whereRaw 或 LIKE；
- ✅ 生成列（STORED）+ 索引是实现 ORDER BY full_name 的最佳实践，兼顾性能与可维护性；
- ❌ 避免在 WHERE 或 ORDER BY 中使用 CONCAT()、TRIM() 等函数，会导致索引失效；
- ? 测试时务必使用 EXPLAIN 验证查询是否命中 FULLTEXT 或 idx_full_name 索引。
通过以上改造，你将获得毫秒级全名搜索响应与稳定的字典序排序能力，同时保持 Laravel 代码的清晰性与数据库层的高性能。
