Laravel Scout 本身不提供搜索能力,仅是抽象层,强弱取决于驱动选择;MySQL 驱动实为 FULLTEXT 封装,中文支持弱且功能有限;MeiliSearch 是当前中小项目的平衡首选,开箱支持中文、纠错等;Algolia 和 Elasticsearch 功能强但各有成本与兼容性问题;toSearchableArray() 是搜索质量关键,需精准控制字段与格式。

Laravel Scout 本身不提供搜索能力,它只是一个搜索抽象层,强不强,完全取决于你选的驱动。
直接说结论:Scout 的集成能力很强,但“搜索强不强”是假问题——它像 USB 接口,插 SSD 还是 U 盘,性能天差地别。关键在驱动选得对不对、配得稳不稳。
MySQL 驱动真能搜?别被名字骗了
MySQL 驱动(database)本质是用 MATCH ... AGAINST + FULLTEXT 索引,不是“全文搜索引擎”,而是 MySQL 原生功能的轻量封装。
- ✅ 适合小到中型项目:博客文章、商品简要描述、后台管理搜索
- ❌ 不支持模糊匹配、拼音搜索、同义词、分词权重、高亮等高级特性
- ⚠️ 容易踩坑:
- 表引擎必须是
MyISAM或InnoDB(5.6+),且字段需显式加FULLTEXT索引 - 中文搜索基本失效(MySQL 原生 FULLTEXT 对中文支持极弱,除非用 ngram 插件且配置
ft_min_word_len=1) -
scout:import导入时若字段含 NULL,可能静默跳过整条记录
- 表引擎必须是
-- 检查是否已建 FULLTEXT 索引(以 posts 表为例) SHOW INDEX FROM posts WHERE Key_name = 'fulltext_title_content'; -- 若无,需手动添加(Scout 不自动建) ALTER TABLE posts ADD FULLTEXT(title, content);
MeiliSearch 是当前最平衡的选择
2026 年初,meilisearch/meilisearch-php v1.10+ 已深度适配 Scout v10+,是中小型 Laravel 项目事实上的默认推荐。
- ✅ 开箱即用的中文分词(基于
tantivy引擎)、拼写纠错、同义词、过滤、排序、分页 - ✅ 启动快、内存占用低,Docker 一条命令就能跑:
docker run -d -p 7700:7700 -v $(pwd)/data.ms:/data.ms getmeili/meilisearch - ⚠️ 注意兼容性陷阱:
-
SCOUT_QUEUE=true必须开启,否则新增/更新模型时索引不同步(Scout 默认同步调用,而 MeiliSearch SDK 的批量操作是异步的) -
toSearchableArray()返回的字段类型必须是字符串或标量;返回数组或对象会触发JSON encode failed错误 - 删除模型后,
scout:flush不清空 MeiliSearch 索引,得手动调用MeiliSearchClient::index('posts')->deleteAllDocuments()
-
Algolia 和 Elasticsearch:强但有代价
-
Algolia:搜索体验最强(实时、AI 建议、A/B 测试),但属于 SaaS,2026 年免费额度缩至每月 1 万次操作,超出后按 $0.99/万次计费。适合 ToC 产品,不适合内部系统或数据敏感场景。 -
Elasticsearch:功能最全,但 Scout 官方不维护 ES 驱动,社区包(如babenkoalex/laravel-scout-elasticsearch)维护滞后,v8.x 兼容性常出问题;Java 进程吃内存,部署运维成本高。
两者共性风险:
- 模型变更后,
scout:import可能因字段映射不一致导致索引失败,错误日志藏在队列失败任务里(failed_jobs表),不易发现 -
search()方法链式调用(如->where('status', 1)->paginate())在 Algolia 中有效,在 ES 驱动中部分条件可能被忽略——因为底层 API 语义不统一
toSearchableArray() 不只是“选字段”,它是搜索质量的开关
这个方法决定什么进索引、以什么形式进,直接影响召回率和准确率。
- ❌ 错误写法:
return $this->toArray();—— 把所有字段(含 JSON、时间戳、关联 ID)塞进去,浪费空间、拖慢搜索、干扰相关性 - ✅ 推荐做法:
- 只保留用户真正搜索的字段(
title,content,tags) - 预处理:把
tags数组 implode 成字符串;把 HTML 内容 strip_tags() - 加权字段:MeiliSearch 支持
searchableAttributes排序,把标题放前面,内容放后面
- 只保留用户真正搜索的字段(
public function toSearchableArray()
{
return [
'title' => $this->title,
'summary' => strip_tags($this->excerpt),
'content' => strip_tags($this->content),
'tags' => implode(' ', $this->tagNames()),
];
}
真正容易被忽略的是:Scout 不校验字段内容合法性。比如你传了个 null 或 resource 进去,某些驱动(尤其是 MeiliSearch)会在导入时静默丢弃整条记录,而控制台毫无提示——必须查队列失败任务或启用 Scout 日志(scout.log)。










