Scout的search()为空主因是索引未同步、模型未启用Searchable或驱动未就绪；where()被忽略因它仅内存过滤，非数据库级条件；分页总数不准因默认游标分页；中文搜不到因驱动分词器不支持。
Scout 的方法本身不执行数据库查询，它只构造搜索请求并委托给底层驱动；搜索结果为空、返回旧数据或条件失效，几乎都源于驱动配置、索引状态或调用方式偏差。
search() 调用后为什么没结果？
这不是代码写错了，而是 Scout 没真正“看见”你要搜的数据。常见原因有三个：
•
没运行，或只对部分模型执行了导入，而你正在搜的模型压根没进索引
• 模型里漏了
，或者
返回空数组（比如写了
或字段名拼错）
• 驱动未就绪：比如
，但 Meilisearch 服务根本没启动，或
地址连不通（可用
快速验证）
where() 条件为什么被忽略？
Scout 的
不是 SQL WHERE，它只在搜索结果返回后做内存过滤——也就是说，先从搜索引擎拿到一批 ID，再用这些 ID 去数据库查记录，最后才用 PHP 过滤
。这导致两个后果：
• 如果搜索引擎返回 10 条结果，但其中只有 2 条满足
，
就只给你 2 条，不是 10 条
• 真正的数据库级筛选必须靠驱动原生支持，比如 Meilisearch 的
参数，就得手动用
注入：
• Algolia 和 Meilisearch 支持更丰富的 filter 语法，database 驱动则完全不支持
下推，纯靠 PHP 过滤
分页时总数不准、跳页异常
Scout 分页默认用的是「游标分页」逻辑（尤其在 Algolia/Meilisearch 中），
返回的
是估算值，不是精确计数。
• 如果你需要准确总数（比如显示“共 247 条结果”），得显式调用
：
，但这会额外发一次请求
• database 驱动下，
实际走的是 MySQL
，总数准，但性能随偏移量增大而下降
• 切勿在分页链式调用中混用
和
：前者触发内存过滤，后者在数据库查完才加载关联，顺序错乱会导致 N+1 或空关联
中文搜索匹配不到关键词
别怪 Scout，它不负责分词——责任在驱动。
• Algolia 默认按空格和标点切词，对中文基本无效；必须开启自定义分词器或改用 Meilisearch
• Meilisearch ≥ 0.29 原生支持中文，但需确认索引已启用：
（只要服务版本够新，通常默认生效）
• database 驱动在 MySQL 中依赖
，而中文单字无法被索引（
是默认值），实际不可用于中文全文检索
• 最小代价验证法：先用 Meilisearch 的 Web UI 直接查
，如果 UI 能搜到，说明问题出在 Laravel 调用层；搜不到，就是引擎或索引配置问题
search()scout:importuse Searchable;toSearchableArray()return [];SCOUT_DRIVER=meilisearchMEILISEARCH_HOSTcurl -I http://127.0.0.1:7700where()where('status', 1)status = 1->get()filterraw()Post::search('api')->raw(['filter' => 'status = 1'])->get()where()paginate(15)total()count()Post::search('laravel')->count()paginate()LIMIT/OFFSETwhere()with()curl -X POST 'http://localhost:7700/indexes/posts/settings' -H 'Content-Type: application/json' --data-binary '{"distinctAttribute": null}'MATCH ... AGAINSTft_min_word_len=4/indexes/posts/search?q=中文