EWS API访问Office 365日历报错：触发场景及解决方法咨询

根据你描述的问题（仅EWS API访问报错，OWA/Outlook正常，部分租户出现），这个错误核心是EWS客户端依赖的ExchangePrincipal对象包含过时的邮箱元数据，以下是可能引发该问题的场景及对应的解决方法：

可能引发报错的场景 #

• 邮箱跨数据库/跨租户迁移：这是最常见的原因，迁移后Exchange服务器更新了邮箱的数据库GUID，但你的EWS客户端缓存了旧的ExchangePrincipal信息，仍然指向原数据库位置。
• 用户UPN（UserPrincipalName）修改：如果应用缓存了旧的UPN或关联的ExchangePrincipal，修改UPN后，旧的标识无法匹配当前邮箱对象。
• 邮箱主SMTP地址/别名重命名：主邮箱地址变更后，EWS客户端若使用旧的邮箱地址或缓存的标识信息，会导致寻址失败。
• 邮箱禁用后重新启用：邮箱禁用时ExchangePrincipal会被标记为无效，重新启用后客户端未更新缓存的信息，仍使用旧的无效对象。
• EWS访问权限变更：比如临时移除用户的EWS权限后又恢复，权限变更可能导致ExchangePrincipal的权限属性过时，引发对象找不到的错误。

对应的解决方法 #

针对不同场景，你可以按以下步骤排查修复：

1. 刷新ExchangePrincipal对象（核心修复）
   如果使用EWS Managed API，不要长期缓存ExchangePrincipal实例，每次访问前主动刷新或重新获取：

   // 重新获取ExchangePrincipal，而不是复用缓存的对象
   var exchangePrincipal = ExchangePrincipal.FromEmailAddress(ewsService, userEmail);
   // 主动刷新元数据
   exchangePrincipal.Refresh();
   

   避免依赖缓存的旧对象，确保每次请求都拿到最新的邮箱数据库、服务器等信息。

2. 清除客户端缓存的邮箱标识
   检查你的应用是否缓存了邮箱GUID、数据库GUID或Exchange服务器地址这类静态数据，全部清除并改为实时获取：

   • 不要硬编码Exchange服务器端点，依赖EWS的AutoDiscover机制自动获取当前有效的服务地址。
   • 每次访问前通过ResolveName方法验证并获取最新的邮箱信息：

     var resolvedResults = ewsService.ResolveName(userEmail);
     if (resolvedResults.Count > 0)
     {
         var targetMailbox = resolvedResults[0].Mailbox;
         // 使用该Mailbox对象进行后续的日历访问操作
     }
     

3. 强制重新触发AutoDiscover
   若应用之前缓存了AutoDiscover的结果，强制清除缓存并重新执行AutoDiscover，确保EWS客户端连接到最新的Exchange服务器端点：

   // 禁用AutoDiscover缓存（按需设置）
   ewsService.AutodiscoverEnabled = true;
   ewsService.EnableScpLookup = true;
   ewsService.Credentials = new WebCredentials(username, password);
   // 重新执行AutoDiscover
   ewsService.AutodiscoverUrl(userEmail, redirectionUrl => true);
   

4. 联系Microsoft 365租户支持
   如果以上方法都无效，可能是租户侧的Exchange元数据存在异常（比如迁移后的残留脏数据），需要提交支持工单，请求微软后台刷新对应邮箱的ExchangePrincipal元数据，修复底层的对象关联问题。

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