Azure Cognitive Search含保留字符&的搜索失败问题求助

你的问题出在Full查询模式下，特殊字符会被当作查询运算符解析，而非字面量。&是Azure Cognitive Search的保留字符，代表逻辑AND，所以你的搜索字符串Rohan_A&F*会被解析为搜索Rohan_A AND F*，而非你预期的字面匹配Rohan_A&F*，导致无法找到目标文档。

以下是三种可行的解决方案：

方案一：转义保留字符 #

在Full查询模式下，用反斜杠\对保留字符进行转义，让引擎将其当作字面量处理：

public async Task AzureSearch()
{
    string searchKey = "Rohan_A&F"; 
    // 转义&为\&，若有其他保留字符也需按此方式转义
    string escapedSearchKey = searchKey.Replace("&", @"\&");
    
    SearchOptions options = new SearchOptions();            
    options.SearchFields.Add("CustomerNm");
    options.Select.Add("Id");
    options.Select.Add("CustomerName");       
    options.QueryType = SearchQueryType.Full;
    options.SearchMode = SearchMode.All;   
    
    var client = CreateSearchClient();
    var response = await client.SearchAsync<Object>($"{escapedSearchKey}*", options);
}

方案二：使用@search.in函数精确匹配 #

如果需要针对特定字段匹配包含特殊字符的内容，可以用@search.in函数，该函数会将输入当作字面量处理，无需转义：

public async Task AzureSearch()
{
    string searchKey = "Rohan_A&F"; 
    
    SearchOptions options = new SearchOptions();            
    options.SearchFields.Add("CustomerNm");
    options.Select.Add("Id");
    options.Select.Add("CustomerName");       
    options.QueryType = SearchQueryType.Full;
    options.SearchMode = SearchMode.All;   
    
    var client = CreateSearchClient();
    // 使用@search.in指定字段和匹配值，支持末尾通配符
    var response = await client.SearchAsync<Object>($@"@search.in(CustomerNm, '{searchKey}*')", options);
}

方案三：切换到Simple查询模式 #

若你不需要Full模式的复杂查询功能（比如布尔逻辑、短语搜索），可以切换到Simple模式，该模式下所有特殊字符都会被当作字面量处理，无需转义：

public async Task AzureSearch()
{
    string searchKey = "Rohan_A&F"; 
    
    SearchOptions options = new SearchOptions();            
    options.SearchFields.Add("CustomerNm");
    options.Select.Add("Id");
    options.Select.Add("CustomerName");       
    options.QueryType = SearchQueryType.Simple; // 切换为Simple模式
    options.SearchMode = SearchMode.All;   
    
    var client = CreateSearchClient();
    var response = await client.SearchAsync<Object>($"{searchKey}*", options);
}

额外验证点 #

• 确认你的搜索索引中，CustomerNm字段确实存在包含Rohan_A&F的文档
• 若有其他保留字符（如+、-、!等），方案一中需要对应转义

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