Microsoft Graph Api订阅到期时lifecycleNotificationUrl未触发求助

核心问题 #

使用Microsoft Graph Webhook监听Outlook todoTasks和Events变更时，notificationUrl可正常接收变更通知，但lifecycleNotificationUrl完全收不到订阅到期预警，无法触发续订逻辑。已验证端点公开可用，测试不同到期时长均无响应。

排查与解决步骤 #

1. 确认生命周期通知的触发时间点 #

微软的订阅到期预警并非在到期前瞬间发送，而是固定在到期前3天、1天、1小时三个时间节点触发。需确认测试场景覆盖这些时间范围：

• 若设置订阅2小时后到期，仅会在到期前1小时收到预警；
• 若设置1天后到期，会在到期前1天和1小时分别收到通知。

2. 验证lifecycleNotificationUrl的响应合规性 #

该端点需满足和notificationUrl相同的响应要求，否则微软会停止发送通知：

• 必须在5秒内返回200 OK，超时会被判定为无效；
• 需支持OPTIONS预检请求（部分环境下微软会先发OPTIONS验证端点可用性），需返回200或204状态码；
• 检查防火墙/WAF规则：确保允许微软通知服务的IP段访问；
• 确认日志配置：检查Salesforce或监控工具是否开启了所有外部POST请求的日志记录，避免遗漏微软的通知请求。

3. 核对订阅创建的正确性 #

• 创建订阅时，检查微软返回的响应体中是否包含lifecycleNotificationUrl字段，确认该字段值与提交的一致；
• 检查字段名拼写：确保请求中使用的是lifecycleNotificationUrl（微软API对字段名大小写敏感）；
• 确认resource路径有效：验证/me/todo/lists/[listId]/tasks对应的任务列表存在且应用有权访问。

4. 检查应用权限配置 #

确保应用拥有足够的权限来触发生命周期通知：

• 针对todoTasks：需Tasks.ReadWrite（委派权限）或Tasks.ReadWrite.All（应用权限）；
• 针对Events：需Calendars.ReadWrite（委派权限）或Calendars.ReadWrite.All（应用权限）；
• 权限需已完成管理员同意（应用权限场景）或用户授权（委派权限场景）。

5. 手动模拟生命周期通知测试 #

直接向lifecycleNotificationUrl发送模拟请求，验证端点是否能正常接收：

POST [你的lifecycleNotificationUrl]
Content-Type: application/json

{
  "value": [
    {
      "subscriptionId": "你的订阅ID",
      "subscriptionExpirationDateTime": "2024-03-08T12:40:00.0000000Z",
      "clientState": "SecretClientState",
      "lifecycleEvent": "subscriptionExpirationWarning"
    }
  ]
}

若端点能正常接收并返回200 OK，说明端点本身无问题，需排查微软通知服务的投递问题；若无法接收，需修复端点的接收逻辑。

6. 重置订阅与测试 #

• 删除现有订阅，重新创建新的订阅，确保请求参数完全正确；
• 使用Graph Explorer创建测试订阅，指定你的lifecycleNotificationUrl，验证是否能收到通知，排除自身代码的问题。

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