Google Calendar Watch初始同步后无后续通知问题求助

我已为Google Calendar配置了Watch：

WatchParamsModel watchParamsModel = new WatchParamsModel
{
    TimeToLive = "2592000000", // 30 days is the max that google will allow
};
WatchRequest requestCode = new WatchRequest
{
    ID = "abc_" + providerID + "_" + calendarID + "_" + DateTimeOffset.Now.ToUnixTimeSeconds(),
    Type = "web_hook",
    Address = address,
    Params = watchParamsModel,
    Token = "token",
};

string requestData = JsonConvert.SerializeObject(requestCode);

string requestUrl = $"https://www.googleapis.com/calendar/v3/calendars/{calendarID}/events/watch?eventTypes=default";

WatchResponse response = this.CreateAndExecuteHttpRequest<WatchResponse>(requestUrl, WebRequestMethods.Http.Post, requestData);
return response;

收到了包含所有预期信息的200响应：

{  
"kind": "api#channel",  
"id": "watchid",  
"resourceId": "abc",  
"resourceUri": "https://www.googleapis.com/calendar/v3/calendars/{calURI}/events?alt=json&eventTypes=default",  
"token": "token",  
"expiration": "1711044580000" 
} 

以及同步通知：

Method: POST, 
RequestUri: 'my endpoint', 
Version: 1.1, 
Content: System.Net.Http.StreamContent, 
Headers:  {    
Accept: */*  Accept-Encoding: gzip  
Host: my host  
User-Agent: APIs-Google; (+https://developers.google.com/webmasters/APIs-Google.html)  
X-Forwarded-For: 123  
X-Forwarded-Proto: https  
X-Forwarded-Port: 443  
X-Amzn-Trace-Id: Root=abc  
CF-RAY: abc 
CF-Visitor: {"scheme":"https"}  
X-Goog-Channel-ID: channelId (same as above)
X-Goog-Channel-Expiration: Thu, 21 Mar 2024 22:47:00 GMT  
X-Goog-Resource-State: sync  
X-Goog-Message-Number: 1  
X-Goog-Resource-ID: resourceId (same as above)
X-Goog-Resource-URI: https://www.googleapis.com/calendar/v3/calendars/{calURI}/events?alt=json&eventTypes=default  
X-Goog-Channel-Token: token (same as above)  
CF-Connecting-IP: 74.125.212.171  
CDN-Loop: cloudflare  
True-Client-IP: 74.125.212.171  
CF-IPCountry: US
}

我的端点会首先记录所有传入请求，但在创建Watch后，对关联Google Calendar进行事件创建、编辑或删除操作时，日志中无相关请求记录。我检查了防火墙，没有来自Google的请求被拦截，能看到同步请求及我们的200响应，但事件编辑时无被拦截或其他相关请求记录。为何初始同步后端点不再收到请求？

可能的原因及排查方案 #

1. 端点响应不符合Google要求 #

Google Webhook要求端点在收到通知后必须返回200 OK状态码，且响应时长不能超过10秒。如果同步通知的响应虽然显示200，但实际处理中存在延迟或者异常（比如日志记录逻辑阻塞了响应），Google可能会标记该端点为无效，停止发送后续通知。

• 排查：简化端点逻辑，先直接返回200，再异步处理日志和业务逻辑，确保响应速度达标。
• 验证：重新创建Watch，然后触发事件变更，观察是否能收到通知。

2. Watch的eventTypes参数限制 #

你的请求中指定了eventTypes=default，这意味着只会接收默认类型事件的变更通知。如果操作的事件属于其他类型（比如outOfOffice、focusTime等），不会触发通知。

• 排查：检查测试用的事件类型是否为default；或者移除eventTypes参数，接收所有类型的事件变更。
• 修改后的请求URL：

  https://www.googleapis.com/calendar/v3/calendars/{calendarID}/events/watch
  

3. 日历权限或资源ID不匹配 #

确保创建Watch时使用的calendarID与你操作的日历完全一致，且授权账号拥有该日历的读取或编辑权限。如果权限不足，Google不会推送变更通知。

• 排查：通过Calendar API的calendars.get接口验证calendarID的正确性，以及当前账号的权限范围。

4. Google推送机制的重试/静默策略 #

如果Google曾经向你的端点发送通知但未收到有效响应，会进入重试机制，多次失败后会暂停推送。即使后续修复了问题，也需要重新创建Watch才能恢复。

• 解决：删除现有Watch（通过channels.stop接口），然后重新创建新的Watch实例。

5. 网络层的隐性拦截 #

虽然防火墙没有拦截记录，但CDN（比如你使用的Cloudflare）可能存在WAF规则、速率限制或者缓存策略，导致Google的请求被拦截但未在日志中体现。

• 排查：
  • 检查Cloudflare的防火墙规则、安全级别设置，暂时关闭WAF测试。
  • 查看Cloudflare的Ray ID对应的请求详情，确认是否有被拦截的记录。
  • 直接访问端点（绕过CDN）测试通知接收情况。

6. Watch实例已过期或被终止 #

虽然响应中显示了expiration时间，但如果存在网络波动或者Google内部的异常，Watch可能提前终止。

• 排查：通过channels.list接口查看当前有效的Watch实例，确认目标Watch是否存在。
• 解决：定期检查Watch状态，提前续期或重新创建。

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