使用Graph SDK实现Webhook订阅日历事件遇问题求助

嘿，我之前在做Graph SDK订阅日历事件的时候也踩过不少坑，先帮你把代码整理得更清晰些，再聊聊几个常见的问题点和解决方案：

规整后的订阅代码 #

var request = GraphClientInitializer.Instance.GraphClient.Subscriptions.Request();
var result = await request.AddAsync(
    new Subscription
    {
        ChangeType = WebhookConsts.SubscriptionChangeType,
        NotificationUrl = WebhookConsts.SubscriptionNotificationUrl,
        Resource = "/users/" + UserMail + "/events",
        ExpirationDateTime = DateTimeOffset.UtcNow.AddMinutes(420) // 注意：微软默认最大过期时间为4230分钟（约3天）
    });

常见问题与排查方向 #

• 资源路径格式问题：你当前用/users/{UserMail}/events是可行的，但如果邮箱包含特殊字符可能会出问题，更稳妥的方式是使用用户ID代替邮箱，或者如果是当前授权用户的话直接用/me/events。
• 过期时间限制：微软Graph订阅的过期时间最大不能超过4230分钟（约3天），如果设置超出这个值会直接返回错误。另外订阅到期后需要手动续订，否则会停止接收通知，记得提前做好续订逻辑。
• NotificationUrl验证失败：这是最容易卡壳的点！创建订阅时微软会向你的NotificationUrl发送验证请求，你必须在10秒内返回请求中的validationToken作为响应内容，示例验证逻辑（ASP.NET Core）：

  [HttpPost]
  public IActionResult WebhookNotification()
  {
      var validationToken = Request.Query["validationToken"];
      if (!string.IsNullOrEmpty(validationToken))
      {
          // 直接返回验证token即可完成验证
          return Content(validationToken, "text/plain");
      }
      // 处理后续的实际事件通知逻辑
      return Ok();
  }
  

• 权限配置错误：确保你的应用已申请并获批正确的权限：如果是后台服务模式需要Calendars.Read或Calendars.ReadWrite的应用权限；如果是用户授权模式则需要对应的委托权限，权限不足会返回403错误。
• ChangeType参数不合法：ChangeType必须是created、updated、deleted中的一个或多个，多个值用逗号分隔（不能有空格），比如"created,updated"，参数错误会导致订阅创建失败。

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