Atlas Search同义词配置后未影响结果分数，请求排查

我使用Atlas Search免费版在产品的多个字段上创建了全文索引，并为性别词汇配置了英法互译的同义词，但在$search管道中使用该同义词后，未发现对结果分数产生影响，查询语句中包含同义词文档里的"homme"一词，以下是相关配置及可能的问题点：

全文索引定义 #

{"analyzer": "lucene.french","searchAnalyzer": "lucene.french","mappings": {"dynamic": false,"fields": {"brand": {"analyzer": "lucene.french","indexOptions": "positions","norms": "omit","searchAnalyzer": "lucene.french","store": false,"type": "string"},"category": {"fields": {"name": {"analyzer": "lucene.french","indexOptions": "positions","searchAnalyzer": "lucene.french","store": false,"type": "string"}},"type": "document"},"color": {"analyzer": "lucene.french","indexOptions": "positions","searchAnalyzer": "lucene.french","store": false,"type": "string"},"description": {"analyzer": "lucene.french","searchAnalyzer": "lucene.french","store": false,"type": "string"},"gender": {"analyzer": "lucene.french","indexOptions": "positions","norms": "omit","searchAnalyzer": "lucene.french","store": false,"type": "string"},"name": {"analyzer": "lucene.french","norms": "omit","searchAnalyzer": "lucene.french","store": false,"type": "string"}}},"synonyms": [{"analyzer": "lucene.french","name": "gender_synonym","source": {"collection": "gender_synonym"}}]}

同义词集合文档示例 #

{"mappingType": "equivalent","synonyms": ["masculin","male","homme","man"]}

$search查询管道 #

[
  {
    "$search": {
          "index": "search",
          "compound": {
            "minimumShouldMatch": 2,
            "should": [
              {
                "text": {
                  "query": "tee shirt rose homme",
                  "path": ["category"],
                  "score": {
                    "boost": {
                      "value": 5
                    }
                  }
                }
              },
              {
                "text": {
                  "query": "tee shirt rose homme",
                  "path": ["gender"],
                  "score": {
                    "boost": {
                      "value": 5
                    }
                  },
                  "synonyms": "gender_synonym"
                }
              },
              {
                "text": {
                  "query": "tee shirt rose homme",
                  "path": ["color", "brand", "name"],
                  "score": {
                    "boost": {
                      "value": 1.5
                    }
                  }
                }
              },
              {
                "text": {
                  "query": "tee shirt rose homme",
                  "path": "description",
                  "score": {
                    "boost": {
                      "value": 1
                    }
                  }
                }
              }
            ]
          }
        }
  }
]

可能的配置错误点 #

• 分析器处理顺序冲突：lucene.french分析器会对文本做词干化处理（比如将"homme"转换为词根形式），而Atlas Search的同义词匹配是在分析器处理之前执行的。如果gender字段存储的是词干化后的内容，或者查询中的"homme"被分析器处理后和同义词集合中的原词不匹配，就无法触发同义词关联。可以尝试将同义词集合中的词汇替换为对应词干形式，或者自定义分析器调整同义词与词干化的执行顺序。
• 查询文本冗余导致权重稀释：在gender字段的查询中传入了完整的"tee shirt rose homme"，其中大部分词汇和gender字段无关，分析器会过滤掉无关词汇，导致同义词匹配的权重被稀释，分数变化不明显。建议单独针对gender字段传入精准查询词（比如只传"homme"）测试同义词是否生效。
• minimumShouldMatch掩盖分数变化：配置了minimumShouldMatch: 2，如果其他should条件（比如category、color/brand/name字段）已经满足匹配要求，gender字段的同义词匹配带来的分数提升可能被忽略，或在整体结果中表现不显著。可以暂时移除该参数，单独观察gender字段的匹配分数变化。
• 同义词集合未生效：确认同义词集合gender_synonym已正确创建，且全文索引是在同义词集合创建后重新生成的。如果索引创建在前、同义词配置在后，需要重新构建索引才能让同义词生效。
• 字段数据不匹配：检查文档中gender字段的实际值是否包含同义词集合中的词汇（比如"masculin"、"male"等），如果字段值是缩写、词干化内容或其他格式，同义词无法匹配到对应文档。

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