multi_match中字段权重提升最常用且易错的是误用顶层boost参数，正确做法是在fields数组中用“字段名^数值”语法（如title^3）显式指定各字段权重，不写^的默认为1。
multi_match 里用 title^3 而不是 boost 字段参数
字段权重提升最常用也最容易写错的地方，就是把 boost 当成字段级加权的唯一方式。实际上，在 multi_match 查询中，直接在字段名后加 ^ 符号才是标准、简洁且高效的做法。
常见错误是这样写：
{"multi_match": {"query": "手机", "fields": ["title", "content"], "boost": 3}}
这会让整个 multi_match 查询整体提权，但 title 和 content 之间没区别——完全达不到“标题更重要”的目的。
正确做法是显式声明字段权重：
{"multi_match": {"query": "手机", "fields": ["title^3", "content^1"]}}
-
title^3表示该字段匹配贡献的 _score 会 ×3（非线性，但趋势明确） - 不写 ^ 的字段默认为 1，无需显式写
content^1 - ES 7.0+ 已弃用
boost作为multi_match的顶层参数，部分版本会静默忽略 - 如果字段用了
copy_to合并索引，注意^只作用于原始字段名，不作用于 copy_to 目标字段
must + filter 混用时，boost 只对 must 里的查询生效
很多 Laravel 项目把上架状态、类目 ID 这类确定性条件也塞进 must，结果发现加了 title^3 却没效果——因为 filter 子句不参与评分，而 must 里混了全文检索和结构化条件，导致 BM25 分数被稀释或归零。
必须严格拆开：
{"bool": {"must": [{"multi_match": {"query": "手机", "fields": ["title^3", "content"]}}], "filter": [{"term": {"on_sale": true}}, {"term": {"category_id": 123}}]}}
-
must仅保留影响相关性的查询（如multi_match、match_phrase） -
filter放所有确定性条件：状态、ID、范围、exists 等，它们不计算 _score，但可缓存 - 一旦把
term放进must，ES 会尝试按词频/IDF 打分，但 term 查询没有词频概念，最终 _score 可能为 0 或不可预期 - Laravel 中用原生客户端构造时，别依赖 Scout 的自动转换——它可能把
where条件全塞进must
避免 function_score 过度设计，优先用 should + minimum_should_match
想让“带促销标签”或“销量高”的商品靠前，第一反应容易写 function_score 加 script 或 field_value_factor。但实际多数场景，用 should 更轻量、更可控。
例如：标题匹配 + 有促销标签 + 销量 > 1000，三者满足任意两个就进结果，且满足越多排名越靠前：
{"bool": {"must": [{"multi_match": {"query": "手机", "fields": ["title^4", "brand^2"]}}], "should": [{"term": {"has_promotion": true}}, {"range": {"sales_count": {"gte": 1000}}}], "minimum_should_match": 1}}
-
should子句命中会提升 _score，不命中也不排除文档（只要must满足） -
minimum_should_match: 1是关键，否则 ES 默认要求全部should都满足，容易漏结果 - 相比
function_score，should不需要额外映射字段、不触发脚本沙箱限制、性能更稳 - 如果真要用
function_score，务必确认目标字段已启用"norms": {"enabled": true}（默认开启），否则field_value_factor可能失效
PHP 数组键名大小写敏感导致 ^ 权重丢失
Laravel 中用 PHP 数组拼 DSL 时，fields 数组若写成 ['Title^3', 'Content']，ES 会查不到字段——因为映射定义的字段名是小写的 title 和 content，而 ES 字段名严格区分大小写。
这个坑在本地开发常被忽略，上线后搜索排序突然失灵。
- 所有字段名必须与 mapping 定义完全一致，通常是小写 + 下划线
- 建议在 Laravel 中统一从模型获取字段白名单：
array_keys($model->toSearchableArray()) - 调试时用 Kibana Dev Tools 直接执行 DSL，看返回的
_score是否随^变化，比看 PHP 日志更直接 - 不要在字段名里加空格或特殊字符，
product_name^2可以，"product name"^2会解析失败
字段权重不是调得越高越好，title^10 可能让内容完全无关但标题撞词的垃圾文档排第一；真正起效的是合理梯度（比如 title^3、brand^2、content^1）配合 clean 的 filter 和稳定的分词配置。
