如何在 Laravel 中高效实现全名搜索与排序（无需 whereRaw）

本文介绍在 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 代码的清晰性与数据库层的高性能。