OpenSearch中结合全文与向量检索仅返回向量结果问题排查

• 评分权重失衡：KNN查询的默认评分通常远高于全文检索的BM25/TF-IDF评分。当用bool should组合时，全文检索的结果因为评分太低，会被默认分页（size默认10）挤到后面，导致你看不到。试着把size参数调大，比如设为20，就能看到混合结果了。

• KNN参数不一致：你说单独跑KNN能得到5条结果，但组合查询里设的k=3，这时候KNN只会返回3条结果。要确保组合查询里的KNN参数和单独测试时一致，比如把k改成5，才能拿到和单独查询一样多的向量结果，再和全文结果混合。

• 查询结构或字段错误：检查组合查询里的multi_match字段是否和单独查询时完全一致，有没有写错字段名。可以临时把组合查询里的KNN部分删掉，只保留multi_match，确认是否能正常返回15条结果，排除字段配置错误的可能。

• 评分体系不兼容：KNN的距离评分和全文检索的文本评分量级差异很大，默认情况下KNN结果的评分会碾压全文结果。可以用function_score给全文查询加权重，或者对KNN评分做归一化，让两者的评分处于同一区间，这样两种结果才能按综合评分正常排序。比如给全文查询加boost系数：

{
  "query": {
    "bool": {
      "should": [
        {
          "function_score": {
            "query": {
              "multi_match": {
                "query": "generic search term",
                "fields": ["content", "title"]
              }
            },
            "boost": 3
          }
        },
        {
          "knn": {
            "embedding": {
              "vector": [0.162953, ...],
              "k": 5
            }
          }
        }
      ],
      "minimum_should_match": 1
    }
  },
  "size": 20
}

• minimum_should_match的隐性影响：虽然设置了minimum_should_match=1，但如果KNN结果的评分足够高，全文结果会排在非常靠后的位置，超出默认返回数量。调大size是最直接的验证方法。

内容的提问来源于stack exchange，提问作者Frank Conry