Elasticsearch中price字段range查询失败，主因是映射为text/keyword而非numeric；须重建索引并确保数值类型，或手动更新mapping为float；TNTSearch不支持range查询，应改用elastic驱动；多条件过滤需用rawQuery结合bool、range和terms；分页超10000应限制页码或改用search_after。
ES 查询价格区间时字段类型必须是 numeric 或 range
直接用 range 查询 price 字段却查不到数据？大概率是该字段在 Elasticsearch 中被映射成了 text 或 keyword。Laravel Scout 默认不会自动推断数值字段类型，建索引时若未显式定义，ES 会按首次插入内容猜测——比如插入 "99.9"（带引号字符串）就会被当 keyword 处理，导致 range 查询失效。
解决方法只有两个：
- 重建索引前，在模型的
toSearchableArray()中确保返回的是原生 PHP 数值：'price' => (float) $this->price - 手动更新 mapping：先关闭索引
POST /products/_close，再PUT /products/_mapping设置"price": {"type": "float"}，最后重新打开并 reindex
Laravel Scout + TNTSearch 不支持 price_range 这种复合查询
如果你用的是 TNTSearch 驱动（非官方 ES 驱动），它根本不支持 range、bool 等 DSL 查询语法。所有搜索都走全文匹配，whereBetween('price', [100, 500]) 这类调用会被 Scout 忽略或报错。
确认你用的是官方 meilisearch 或 elastic 驱动：
- 检查
config/scout.php中'driver' => 'elastic' - 运行
php artisan scout:flush "App\Models\Product"清空旧索引，再php artisan scout:import "App\Models\Product" - 别在
search()链式调用里混用where()和whereBetween()—— Elastic 驱动只认where()的等值匹配，范围查询必须用原生 DSL
用 rawQuery 实现 price 和 category 同时过滤的正确写法
Scout 的 search() 不支持多条件组合的布尔查询，得退到 rawQuery 层。下面这段代码能同时满足「价格在 80–200 之间」且「category_id 是 3 或 5」：
Laravel Cloud
下载
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
$results = Product::search('', function ($engine, $query, $options) {
return $engine->search($query, [
'body' => [
'query' => [
'bool' => [
'must' => [
['range' => ['price' => ['gte' => 80, 'lte' => 200]]],
['terms' => ['category_id' => [3, 5]]]
]
]
]
]
]);
});
注意点：
-
range的键名必须和 ES mapping 中字段名完全一致（区分大小写，不能是Price或PRICE） -
terms用于多值精确匹配，不是term；如果category_id是 nested 类型，要改用nested查询 - 不要在
search('')第一个参数传空字符串以外的内容，否则会叠加全文检索，干扰范围结果
分页时 from/size 超过 10000 怎么办
ES 默认限制 from + size ≤ 10000，翻到第 500 页（from=4990）就可能触发 "Result window is too large" 错误。这不是 Laravel 问题，是 ES 自身设计。
两种务实解法：
- 前端限制最大页码（比如只允许查前 200 页），并在控制器里加校验：
if ($request->page > 200) abort(400) - 改用
search_after：第一次查完记录下hits['hits'][last]['sort']值，下次请求带上'search_after' => [...]，不依赖from
别碰 index.max_result_window 配置——调高后内存和响应延迟会明显上升，尤其数据量大时。
