调用Microsoft Graph Messages.Delta接口出现类型转换报错咨询

在使用Microsoft Graph SDK开展业务时遇到异常问题，具体信息如下：

两天前首次在某客户场景下调用GraphServiceClient.Me.MailFolders[id].Messages.Delta()接口时出现如下报错：

Unable to cast object of type 'Microsoft.Exchange.Data.Storage.NullableData`2[Microsoft.Exchange.Data.Storage.DateTimeData,Microsoft.Exchange.ExchangeSystem.ExDateTime]' to type 'Microsoft.Exchange.Data.Storage.DateTimeData'.

初步排查信息：

• 最初判断为单个客户的邮件文件夹数据异常，但近两日该报错已在多个不同客户的使用场景中陆续出现
• 调用该接口的相关代码已稳定运行超过1年，在自有测试账号、Graph Explorer环境中均无法复现该问题
• 已将依赖的Microsoft.Graph和Microsoft.Graph.Core包升级至最新版本（分别为4.34.0和2.0.9），问题仍然存在。

解答 #

根因 #

这是Exchange Online服务端近期灰度推送更新引入的后端序列化bug，和客户端SDK版本、业务代码逻辑、客户侧邮件数据本身均无关联：

• 报错抛出位置完全在Exchange服务端存储层，服务端构造delta接口返回内容时，对可空类型的日期属性（常见为草稿、已删除邮件、回收站内邮件的lastModifiedDateTime、receivedDateTime字段）做了错误的强制类型转换，将NullableData<DateTimeData>类型直接强转为DateTimeData触发异常
• 多租户陆续触发、测试环境无法复现、升级SDK无效的表现，完全符合微软服务端分批次灰度发布的特征：异常发生在服务端生成响应阶段，根本不会走到SDK本地反序列化响应的流程，因此升级客户端依赖没有任何作用。

临时规避方案 #

微软完成服务端问题全量修复前，可通过以下方式绕过异常恢复业务：

1. 调用delta接口时通过Select方法显式指定返回字段，暂时剔除所有日期类字段，先拉取邮件ID等核心标识字段，再通过Graph批量请求接口补全需要的时间属性，示例代码：

   var deltaPage = await graphClient.Me.MailFolders["{target-folder-id}"].Messages
       .Delta()
       .Select("id,subject,from,toRecipients,isRead,hasAttachments,categories")
       .GetAsync();
   

2. 若需要保留delta接口的全量字段返回能力，调用时手动添加Prefer: outlook.timezone="UTC"请求头，该请求头会让请求路由到服务端旧的序列化逻辑分支，不会触发该类型转换bug。
3. 针对受影响的付费M365租户，可直接在管理中心提交高优先级支持工单，标注为Exchange服务端回归问题，申请将对应租户临时移出灰度更新范围，通常24小时内即可恢复接口正常调用。

后续说明 #

该类服务端灰度bug一般会在问题收集上报后的3-5个工作日内完成全量回滚修复，修复完成后接口会自动恢复正常，不需要业务侧调整代码或重新发布版本。

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