使用Microsoft Graph API按iCalUId查询用户日历事件失败问题咨询

问题背景 #

用户创建了邀请会议室的日历事件：用户日历中的事件A与会议室日历中的事件B通过相同iCalUId关联。使用GET /users/${userId}/events/?$filter=iCalUId eq '${icaluid}'查询时：

• 用会议室ID作为userId能正常返回事件B
• 用用户ID作为userId返回undefined，但通过GET /users/${email}/calendar/events能查到事件A，且其iCalUId符合预期。该事件的transactionId格式为localevent:，区别于其他事件，且非系列事件、未删除、双方均已接受。

1. 如何复现该问题 #

根据事件的transactionId特征（localevent:前缀），推测该事件是通过Outlook桌面客户端离线创建后同步到Exchange/Graph的，复现步骤可参考：

• 断开网络连接，在Outlook桌面端创建一个邀请会议室的日历事件
• 填写事件详情并邀请会议室资源，保存事件
• 重新连接网络，等待事件同步到服务器
• 同步完成后，使用Graph API分别按iCalUId查询用户日历和会议室日历的事件

这类本地离线创建的事件，会生成带有localevent:前缀的transactionId，可能触发Graph API过滤逻辑的特殊处理，导致查询差异。

2. 为何按iCalUId查询用户日历的事件A无法返回 #

核心原因大概率是Graph API对带有localevent:前缀的本地同步事件的索引/过滤逻辑差异：

• 当事件通过离线客户端创建并同步时，服务器端对用户日历中该事件的iCalUId字段可能未正确建立可被$filter检索的索引，而会议室日历中的事件B是服务器端处理邀请后生成的，索引正常。
• 另一种可能是，这类本地事件的iCalUId在用户日历的存储格式存在隐性差异（比如存在不可见字符、编码差异），直接通过GET /users/${email}/calendar/events返回的iCalUId看起来一致，但实际与过滤条件中的值存在细微区别。
• 此外，transactionId为localevent:的事件属于客户端本地发起的事务，Graph API的事件过滤接口可能对这类事件的处理优先级较低，导致$filter无法匹配到用户日历中的事件A。

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