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