Scout 配置 Elasticsearch 搜不到数据，主因是驱动未切为 elasticsearch、客户端不兼容、ES 地址配置错误、索引未同步或未装 IK 插件导致中文分词失效；需正确设置 SCOUT_DRIVER、安装 elasticsearch/elasticsearch 客户端、配置 hosts、手动导入索引、指定中文分词器并验证 mapping。
Scout 配置 Elasticsearch 时为什么搜不到数据
默认 Scout 使用 Algolia，换成 Elasticsearch 后搜不到结果，大概率是驱动没切对或索引没同步。Laravel Scout 的 SCOUT_DRIVER 必须设为 elasticsearch，且要确保 elasticsearch/elasticsearch PHP 客户端已安装（不是官方的 elastic/elasticsearch-php，后者不兼容 Scout v10+）。config/scout.php 中的 elasticsearch 配置块必须存在并正确指向你的 ES 实例地址，比如：'hosts' => ['http://localhost:9200']。
- 运行
php artisan scout:import "App\Models\Post"手动触发索引重建，不要只依赖模型事件 - 检查 ES 是否真的收到数据：用
curl http://localhost:9200/posts/_search?pretty直接查索引内容 - 确认模型实现了
Searchabletrait，并且toSearchableArray()返回的字段是你想搜的（比如没把content字段漏掉）
搜索时关键词被截断或分词不准怎么办
Elasticsearch 默认使用 standard 分词器，对中文基本无效。不改分词器，搜“数据库优化”会拆成“数据”“库”“优化”，匹配精度极低。必须为中文字段显式指定 ik_smart 或 ik_max_word 分词器（需提前在 ES 中安装 ik 插件）。
- 在模型的
shouldBeSearchable()之外，单独定义 mapping：通过php artisan scout:flush "App\Models\Post"清空后，用 ES API 手动创建带中文分词的 index - 或者用
laravel/scout提供的customIndexSettings()方法（v10.1+），返回包含"analysis"配置的数组 - 搜索时避免直接用
where()，改用search('关键词')->where('status', 1)->get()，否则 Scout 会退化为数据库查询
Scout + Elasticsearch 查询慢，尤其高亮和聚合时
默认 Scout 的 search() 不支持高亮、聚合、suggest 等 ES 原生功能，强行用 raw() 又绕过 Scout 抽象层，容易出错。性能瓶颈常出现在未设置 size 导致 ES 返回全部匹配文档，或未加 filter 上下文（比如用 must 做范围筛选，而不是 should）。
- 用
search('xxx')->raw(function ($builder) { return $builder->highlight(['fields' => ['title' => new \stdClass]]); })注入高亮参数 - 聚合需手动拼
aggs，但注意 Scout 不解析返回结构，得自己从response['aggregations']里取值 - 写复杂查询前先用 Kibana Dev Tools 跑一遍 DSL，确认响应时间合理再搬进 Laravel
线上部署后搜索突然失败，报 “No alive nodes found”
本地跑得通，上线就报这个错，基本是网络或权限问题。Elasticsearch 服务可能绑定了 127.0.0.1，没开放给 Laravel 所在容器/服务器访问；或者开了 xpack 安全模块但 Scout 没配用户名密码。
- 检查
config/scout.php中elasticsearch.hosts是不是用了localhost—— 容器里它指向自己，不是宿主的 ES - ES 配置中确认
network.host设为0.0.0.0或具体内网 IP，且防火墙放行 9200 端口 - 如果 ES 启用了认证，必须在
hosts数组里写成'https://user:pass@host:9200'格式
