laravel 默认搜索慢因mysql全表扫描，es需手动配置中文分词、数据同步与查询逻辑。关键三步：装客户端、配连接、写查询；须用ik分词器、job同步、bulk重建索引。
为什么 Laravel 默认搜索慢，Elasticsearch 又不是“装上就快”
因为 Laravel 的 where、like 或 Eloquent 关系查询走的是 MySQL 全表扫描或索引前缀匹配，文本模糊搜索一多，SELECT * FROM posts WHERE title LIKE '%关键词%' 这种在万级数据上就明显卡顿。Elasticsearch 不是数据库替代品，它是倒排索引专用引擎——但直接装好 ES、改几行代码就指望搜索变快，大概率会遇到数据不同步、中文分词失效、查询结果不相关等问题。
Laravel 用 elasticsearch-php 客户端连 ES 的关键三步
别碰 Laravel Scout（除非你确定要用 Algolia 或需要全自动同步），先手写客户端调用，可控性强、出问题能定位到具体请求。核心是：装客户端、配连接、写查询逻辑。
- 用 Composer 装官方客户端：
composer require elasticsearch/elasticsearch - 在
config/services.php加配置项：'elasticsearch' => ['hosts' => ['http://127.0.0.1:9200']]，注意协议必须带http://，ES 8.x 默认启用了 HTTPS，本地开发没配证书就别强行用https:// - 初始化客户端别写死在控制器里：
$client = ClientBuilder::create()->setHosts(config('services.elasticsearch.hosts'))->build();，建议封装成 Service 类或通过 Laravel 的容器绑定
中文搜索不准？90% 是分词器没对上
ES 默认的 standard 分词器把“搜索引擎优化”切成“搜”“索”“引”“擎”“优”“化”，根本没法查。必须显式指定中文分词器，比如 ik_smart 或 ik_max_word（需提前在 ES 中安装 ik 插件）。
- 建索引时就得定好分析器：
PUT /posts请求 body 里要包含"analyzer": "ik_max_word"字段 - 查询时不能只写
match，得加"analyzer": "ik_smart"，否则 ES 会用字段 mapping 里定义的 analyzer 去分析查询词，而它可能和你索引时用的不一致 - 测试分词是否生效，直接调用
GET /posts/_analyze?analyzer=ik_smart，body 传{"text":"Laravel 搜索优化"}，看返回的 tokens 是不是合理切分
数据同步延迟怎么办：不要依赖模型事件自动推送
用 saved、deleted 这类模型事件往 ES 写数据，看着方便，但事务失败、队列崩溃、ES 临时不可用都会导致 MySQL 和 ES 数据不一致，且难以发现。
- 同步逻辑必须可重试：把 ES 写入操作包进 Laravel Job，失败后进
failed_jobs表，人工可查可重发 - 避免实时强一致：允许秒级延迟，用
updated_at时间戳做增量同步，而不是监听每个变更 - 上线前跑一次全量重建：
php artisan es:reindex posts，这个命令应调用SearchService::reindex()，内部用bulk批量写入，别用单条index请求
最麻烦的从来不是怎么连上 Elasticsearch，而是怎么让每次搜索返回的结果既快又准——分词配置错一点，查“PHP 教程”可能捞出一堆“Java 教培”；同步机制松一点，删掉的记录还在 ES 里挂着。这些细节藏在 config、mapping、job retry 策略和分词测试里，不在文档第一行。
