使用Google自定义搜索API时偶发400无效值异常求助

我之前在.NET 4.7.1 + VS2017环境下使用Google.Apis.Customsearch.v1（1.32.2.1146版本）时，也碰到过这个偶尔出现的Google.GoogleApiException: Invalid Value [400]异常，折腾了好一阵才梳理出几个靠谱的排查和解决方向，你可以逐一验证：

• 检查请求参数的合法性
  Google自定义搜索API对参数的格式和取值范围要求很严格，这是最常见的触发原因：

  • 确认cx（自定义搜索引擎ID）和Key（API密钥）没有拼写错误，并且在Google Cloud控制台已正确启用自定义搜索API；
  • 搜索关键词q如果包含特殊字符（比如&、=、%等），必须用Uri.EscapeDataString()进行转义，避免服务器解析参数出错；
  • 注意num参数的取值范围是1-10，超过这个范围也会返回Invalid Value；
    示例代码（转义关键词）：

  var rawQuery = "用户输入的包含&特殊字符的关键词";
  var escapedQuery = Uri.EscapeDataString(rawQuery);
  var searchRequest = customSearchService.Cse.List(escapedQuery);
  searchRequest.Cx = "你的搜索引擎ID";
  searchRequest.Key = "你的API密钥";
  

• 排查API调用配额是否超限
  虽然错误码是400，但有时候配额超限也会返回不准确的错误信息。你可以登录Google Cloud控制台，查看自定义搜索API的用量统计：

  • 免费版每天只有100次查询配额，超出后会被限制；
  • 如果是配额问题，要么升级到付费版，要么在代码中添加调用频率控制，避免短时间内大量请求。

• 尝试升级或降级库版本
  你使用的1.32.2.1146版本比较老旧，可能存在和.NET 4.7.1兼容的小问题，或者已知的参数解析bug：

  • 可以尝试升级到兼容.NET 4.7.1的最新稳定版（确认NuGet上的版本兼容说明）；
  • 如果升级后问题依旧，也可以回退到更稳定的旧版本试试。

• 添加网络异常重试机制
  偶尔出现的异常可能和网络波动、请求超时有关，导致请求不完整被服务器判定为参数无效：

  • 可以用Polly这类重试库，针对GoogleApiException（尤其是400、503这类临时错误）添加重试逻辑；
    示例代码（Polly重试）：

  var retryPolicy = Policy.Handle<GoogleApiException>(ex => 
      ex.Error.Code == 400 || ex.Error.Code == 503)
    .WaitAndRetry(3, retryAttempt => TimeSpan.FromSeconds(Math.Pow(2, retryAttempt)));
  
  retryPolicy.Execute(() => {
      var searchResponse = searchRequest.Execute();
      // 处理搜索结果
  });
  

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