使用o365rwsclient获取Office365 Message Trace日志报错如何解决

问题原因 #

• API限流规则调整：Office 365 Reporting Web Service内置请求频率、并发连接限制，近期服务端调整了限流阈值，你连续2-3分钟高频分页请求刚好触发限制，直接导致请求失败被客户端包装为聚合异常。你当前设置的$top=2000是接口允许的最大值，连续分页请求时触发限流的概率极高。
• 客户端代码缺陷：你使用的o365rwsclient库中GetAsyncResult方法采用Task.Wait()同步阻塞的方式等待异步请求结果，这种写法极易引发线程池死锁，当服务端响应延迟升高时就会抛出你遇到的异常堆栈。
• 请求参数格式隐患：你提供的请求示例中，StartDate参数值存在多余空格datetime'2021-10-01T00: 57:35'，00:和57之间的空格不符合接口参数规范，服务端校验严格时会直接拒绝请求。
• 旧版接口服务端调整：微软已逐步推进旧Reporting Web Service向Graph API的迁移，近期服务端对旧接口的兼容性逻辑做了调整，旧客户端的调用逻辑适配性不足导致报错。

解决方案 #

• 调整请求策略 #

  • 将$top参数从2000调整为1000，每次分页请求后增加1~2秒的等待时间，降低请求频率避免触发限流
  • 限制客户端到reports.office365.com的并发连接数不超过2，避免并发请求过多被服务端拒绝

• 修复客户端阻塞调用问题 #

  修改o365rwsclient库中GetAsyncResult方法的同步阻塞逻辑，改为异步非阻塞写法：
  原代码：

  private T GetAsyncResult<T>(Task<T> asyncFunction)
  {
      asyncFunction.Wait();
      return asyncFunction.Result;
  }
  

  修改后代码：

  private async Task<T> GetAsyncResult<T>(Task<T> asyncFunction)
  {
      return await asyncFunction.ConfigureAwait(false);
  }
  

  所有调用GetAsyncResult的上层逻辑同步改为await异步调用，完全移除同步等待逻辑。

• 修复请求参数 #

  检查所有请求的日期参数格式，确保符合datetime'YYYY-MM-DDThh:mm:ss'的规范，移除多余的空白字符。

• 增加容错重试逻辑 #

  为请求添加指数退避重试机制，遇到429（限流）、5xx类服务端错误时，依次等待1s、2s、4s后重试，最多重试3次，避免单次请求波动导致程序异常。

内容的提问来源于stack exchange，提问作者Trung Phạm