es返回的_id是字符串，直接传给user::find()会失败；必须在模型中设置$incrementing=false和$keytype='string'，并用user::find($hit['_id'])查询。
ES查出来的ID怎么喂给Eloquent查库
直接把 Elasticsearch 返回的 id 字段丢进 User::find() 会失败——ES 的 id 是字符串（比如 "abc123"），而 Eloquent 默认主键是整型，且不校验类型就直接拼 SQL，结果查不到或报错。
- 确认模型主键类型：如果数据库主键是 UUID 或字符串，必须在模型里写
public $incrementing = false;和protected $keyType = 'string'; - ES 返回的 ID 通常是
_id字段，不是你业务字段里的id；查库时要用它作为主键值，比如User::find($hit['_id']) - 批量查库别用循环
find()，改用User::whereIn('id', $ids)->get()，但注意$ids必须和数据库字段类型一致（字符串数组 or 整型数组） - 如果 ES 存的是业务 ID（如
user_id: 123），那就用whereIn('user_id', $esIds)，别硬套find()
toSearchableArray() 返回字段和数据库字段对不上怎么办
ES 索引数据来自模型的 toSearchableArray()，但这个方法返回的键名默认和数据库字段一致，一旦你加了访问器、重命名字段或用了驼峰，ES 里存的就是加工后的值，查库时字段对不上就会漏数据。
- 避免在
toSearchableArray()里调用访问器（$this->full_name），改用原始属性（$this->name . ' ' . $this->surname）或显式取值 - 如果 ES 需要搜索“分类路径”，但数据库只存
category_id，就得在toSearchableArray()里手动关联查出category_path并塞进去，不能指望 Eloquent 自动补 - 时间字段别直接 return
$this->created_at->toDateTimeString()，ES 8.x 推荐用 ISO8601 格式：$this->created_at->toISOString() - 布尔字段导出前强转：
'is_active' => (bool) $this->is_active，防止 ES 收到 null 或字符串导致查询失效
ES分页和Eloquent分页不兼容怎么统一
Elasticsearch 的 from/size 和 Eloquent 的 paginate() 完全两套逻辑：前者是偏移+数量，后者依赖 SQL LIMIT/OFFSET 和总数统计。混用会导致跳页、重复或漏数据。
- 别用
paginate()包 ES 结果——它会尝试查总数，而 ES 的track_total_hits在大数据量下不准也不高效 - ES 分页建议用
search_after（游标分页），配合sort字段（如['_id' => 'desc']），避免 deep pagination - 如果必须用偏移分页，ES 查完后只取
$hits['hits']，再用collect($hits)->slice($offset, $limit)模拟分页，总数用$hits['total']['value']（注意：ES 8.x 默认只返回近似值） - 前端传来的
page=3&per_page=20要转成 ES 的from=40&size=20，别直接喂给paginate()
高亮字段怎么安全注入到Eloquent模型里
ES 返回的 highlight 是纯 HTML 片段（如 <em>关键词</em>），直接 assign 给模型属性会污染原始数据，也容易 XSS。
- 不要覆盖模型原始字段，比如
$user->title = $highlight['title'][0]；应该挂载到临时属性：$user->highlight_title = $highlight['title'][0] ?? $user->title - 模板里输出前必须用
{{ $user->highlight_title }}（自动转义），千万别用{!! $user->highlight_title !!} - 如果字段可能为空（
$highlight['content']不存在），一定要判空：$highlight['content'][0] ?? $user->content，否则 PHP Notice - 高亮字段名必须和
toSearchableArray()里定义的一致，ES 不会自动映射别名；比如你索引时存的是'post_body'，高亮就得配"fields": {"post_body": {}}
