使用Azure Cognitive Search .NET客户端库配置评分配置文件无效求助

核心排查步骤 #

1. 验证评分配置文件名称匹配度 #

确认代码中指定的DeliveryScoringProfile名称与Azure门户中创建的评分配置文件完全一致（区分大小写、无多余空格）。Azure Cognitive Search的资源名称大小写敏感，任何字符差异都会导致无法匹配目标配置。

2. 检查反射设置的评分参数正确性 #

• 核对反射代码对ScoringParameters和ScoringStatistics的设置逻辑：
  • 确保ScoringParameters的参数结构正确，比如对应func1-val1的参数应写成new ScoringParameter("func1", new[] {"val1"})，而非直接拼接字符串；
  • 确认ScoringStatistics的取值（如Global）与门户查询时使用的统计范围一致，若门户用了全局统计但代码未设置，会导致评分计算逻辑偏差。
• 可以序列化SearchOptions并输出，对比门户查询的请求体（通过浏览器F12查看网络请求），检查参数是否完全匹配：

  var json = System.Text.Json.JsonSerializer.Serialize(searchOptions);
  Console.WriteLine(json);
  

3. 排查排序规则优先级 #

检查代码中是否额外设置了SearchOptions.Sort选项。如果存在自定义排序规则，会直接覆盖评分配置的排序逻辑，导致评分结果不生效——门户查询默认按评分排序，若代码手动添加Sort，会优先执行Sort规则。

4. 确认查询索引的正确性 #

验证.NET客户端查询的索引名称是否与门户中配置目标评分配置的索引完全一致，避免误查询了未配置该评分配置的索引。

5. 核对评分函数参数类型 #

如果评分函数是字段依赖型（如magnitude或freshness函数），确认反射传递的参数值类型符合要求：

• 比如freshness函数需要传入日期格式字符串，magnitude需要数值类型，参数类型不匹配会导致函数失效。

6. 对比查询响应的评分详情 #

在.NET客户端的查询结果中，提取每个文档的@search.score字段，与门户查询的对应文档评分做对比：

• 若评分值一致但排序不同，可能是多个文档评分相同，此时默认按文档ID等规则排序；
• 若评分值差异较大，说明代码中的评分参数或配置匹配存在问题。

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