Azure AI Search单复数搜索不匹配问题求助（API 2024-07-01）

问题根因 #

en.microsoft和nb.microsoft这类微软预构建语言分析器的处理逻辑存在不对称性：

• 索引阶段：会自动将复数词汇词干化为单数（比如把"squats"转成"squat"，挪威语复数同理）
• 查询阶段：仅对单数查询词执行词干化，对复数查询词不做处理

这就导致了你遇到的现象：搜单数时，查询词被转成单数，能匹配索引里已经被词干化的单复数条目；但搜复数时，查询词保持原样，而索引里的复数已经被转成了单数，自然匹配不到。

可行解决方案 #

1. 强制查询阶段使用同索引一致的分析器 #

在发起查询时，指定queryType为full，并显式设置与索引字段相同的分析器，让查询词也经过完整的词干化处理。

• REST API示例：

{
  "search": "squats",
  "queryType": "full",
  "analyzer": "en.microsoft",
  "select": "target_field_name"
}

• .NET SDK示例：

var searchOptions = new SearchOptions
{
    QueryType = SearchQueryType.Full,
    AnalyzerName = "en.microsoft"
};
var searchResult = await searchClient.SearchAsync<YourDataModel>("squats", searchOptions);

挪威语索引只需把analyzer换成nb.microsoft即可。

2. 添加双向单复数同义词映射 #

如果不想修改查询逻辑，可以通过同义词映射补全双向匹配：

1. 创建同义词映射（比如命名为bi-directional-plurals）：

{
  "name": "bi-directional-plurals",
  "format": "solr",
  "synonyms": [
    "squat, squats",
    // 按需添加其他英语单复数对；挪威语示例："bok, bøker"
  ]
}

2. 将该同义词映射关联到索引的可搜索字段：

{
  "name": "your_searchable_field",
  "type": "Edm.String",
  "searchable": true,
  "analyzer": "en.microsoft",
  "synonymMaps": ["bi-directional-plurals"]
}

这样无论搜索单数还是复数，都会自动映射到对应的另一形式，实现双向匹配。

3. 自定义分析器统一词干化逻辑 #

如果需要更灵活的控制，可以创建自定义分析器，确保索引和查询阶段执行完全一致的词干化：

• 英语自定义分析器示例（使用porter_stem词干过滤器）：

{
  "name": "custom-en-stem-analyzer",
  "@odata.type": "#Microsoft.Azure.Search.CustomAnalyzer",
  "tokenizer": "standard_v2",
  "tokenFilters": ["lowercase", "porter_stem"]
}

• 挪威语则替换为norwegian_stem过滤器：

{
  "name": "custom-nb-stem-analyzer",
  "@odata.type": "#Microsoft.Azure.Search.CustomAnalyzer",
  "tokenizer": "standard_v2",
  "tokenFilters": ["lowercase", "norwegian_stem"]
}

然后将索引字段的analyzer设置为这个自定义分析器，查询阶段会自动复用相同的分析器处理查询词，彻底解决单复数匹配不对称的问题。

验证步骤 #

修改配置后，执行以下测试确认效果：

• 搜索复数词（如"squats"），检查是否能返回包含单数形式的结果
• 搜索单数词，确认仍能同时匹配单复数条目，确保原有功能不受影响

内容的提问来源于stack exchange，提问作者Vilhelm H.