Microsoft Graph添加日历事件报Resource could not be discovered错误

核心排查方向 #

按优先级从高到低排查以下问题：

• 目标用户邮箱未完成预配
  调用/users/{user_object_id}接口能正常返回，仅代表Azure AD中存在该用户目录对象，不代表用户已开通Exchange Online邮箱。这是该错误最高发的原因：未给用户分配包含Exchange Online的Office 365许可证、刚分配许可证后端邮箱还没完成同步、用户邮箱被迁移/禁用，都会导致Graph找不到对应的日历资源。
  验证方式：先调用GET https://graph.microsoft.com/v1.0/users/{user_object_id}/mailboxSettings，如果这个接口同样返回Resource could not be discovered，就能确定是邮箱侧的问题，和事件接口无关。可以登录Exchange管理中心确认用户邮箱状态为「已预配」，或直接用该用户账号登录Outlook网页版确认能正常访问日历，刚分配许可证的场景最多等待24小时等后端同步完成。
• 应用权限未完成租户级管理员同意
  你当前配置的User.Read是委托权限，在client_credentials客户端凭证流下完全不生效，该流只会识别应用程序类型的权限。你虽然添加了Calendars.ReadWrite应用权限，但如果没点击「授予管理员同意」完成租户级授权，申请到的令牌里不会携带该权限，调用日历接口时会因为权限不对被路由到错误的资源节点报找不到。
  验证方式：本地解析你拿到的访问令牌（JWT格式），检查roles声明段是否包含Calendars.ReadWrite值，如果没有就说明权限授权没完成。
• 用户ID传值错误或云环境不匹配
  不要用用户UPN（邮箱地址）代替用户Object ID拼接口路径，也不要抄错ID字符，可以先调用GET https://graph.microsoft.com/v1.0/users?$select=id,userPrincipalName,mail拉取用户列表，复制对应目标用户的正确ID再调用接口。如果你的租户属于中国区世纪互联运营、美国政府云等特殊云环境，不能用全球版Graph端点，要替换成对应云环境的服务端点。
• 请求体不符合要求
  创建事件的POST请求必须携带必填字段：subject、带时区信息的start时间、带时区信息的end时间，缺字段也可能触发资源解析错误。

修复步骤 #

1. 给目标用户分配包含Exchange Online的有效许可证，确认邮箱可正常访问，等待预配完成
2. 在Azure AD应用注册页，删除客户端凭证流用不上的委托权限（如User.Read），对Calendars.ReadWrite应用权限执行租户级管理员同意
3. 重新申请访问令牌，本地解析确认roles声明包含Calendars.ReadWrite权限
4. 先调用/users/{user_object_id}/mailboxSettings确认邮箱资源可访问，再调用事件创建接口，参考最小可用请求体如下：

{
  "subject": "测试日程",
  "start": {
    "dateTime": "2024-06-15T09:00:00",
    "timeZone": "China Standard Time"
  },
  "end": {
    "dateTime": "2024-06-15T10:00:00",
    "timeZone": "China Standard Time"
  }
}

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