EWS迁移Graph API后自定义CalendarItem UID与ical_uid不一致问题咨询

算力阿峰

2026-8-24

解决EWS迁移Graph API后事件UID同步不一致的问题

问题背景

通过EWS的CreateItem接口创建Exchange日历事件时，自定义了UUID作为<t:UID>字段，该值能在EWS查询、MAPI属性（GlobalObjectId/CleanGlobalObjectId）中保持一致。但使用Graph API正式版查询同一事件时，ical_uid字段与自定义UUID完全不同，导致同步异常；仅Graph API Beta版的uid字段能返回正确的自定义UUID。

解决方法

1. 采用Graph API Beta版的`uid`字段

Beta版本的Graph API中，事件对象的uid字段直接对应EWS设置的原始UUID（与MAPI的CleanGlobalObjectId、EWS返回的UID完全一致），可直接用于同步匹配。

注意：Beta版API存在变更风险，生产环境使用前需评估稳定性，或等待该特性推送到正式版。

2. 从正式版`ical_uid`中提取原始UUID

若必须使用Graph API正式版，ical_uid的格式通常为{自定义UUID}@{Exchange域名}，可通过字符串截取提取@符号前的UUID部分。
比如ical_uid为81d5f321-af6c-45ae-9cac-ef096ef32069@yourdomain.com，截取@之前的内容即可得到原始UUID。

注意：该规则依赖Exchange配置，需先验证现有事件的ical_uid格式一致性，再批量处理。

3. 统一用Graph API创建事件并指定`uid`

后续新创建事件时，直接调用Graph API的events接口，在请求体中显式指定uid为自定义UUID，从根源保证EWS与Graph API读取的UID一致。
示例请求：

POST /me/events
{
  "subject": "subject",
  "uid": "81d5f321-af6c-45ae-9cac-ef096ef32069",
  "start": {
    "dateTime": "2022-07-28T17:00:00+02:00",
    "timeZone": "Romance Standard Time"
  },
  "end": {
    "dateTime": "2022-07-28T17:30:00+02:00",
    "timeZone": "Romance Standard Time"
  },
  "sensitivity": "normal",
  "isAllDay": false,
  "legacyFreeBusyStatus": "busy"
}