Google Calendar API修改事件为全天时etag异常致ifMatch补丁失败

结论 #

Google Calendar API 不存在etag值下降的合理设计场景，你遇到的是普通事件转全天事件场景下的后端异步处理并发bug。

根因说明 #

• 普通时段事件转换为全天事件时，后端除了执行你主动发起的时间属性修改外，还会触发一个静默的异步校准操作，用于适配全天事件的时区规则、校正重复事件的周期匹配逻辑，这个操作不会对外暴露变更详情，仅会在内部变更队列里生成一条记录。
• 你第三步发起的第二次patch和后端的异步校准操作出现了队列并发：你的patch先执行完成，返回给你正确的etag=2，后执行的校准操作因为没有实际修改事件可持久化属性，没有更新后端存储的etag值，但错误地向增量同步流推送了一条携带etag=3、时间戳和你第三步patch完全一致的无效变更记录。
• 增量同步的sync token会将etag=3标记为当前最新同步位点，但后端实际存储的事件etag还是2，就会出现你遇到的矛盾：用etag=3请求报错、拉增量也没有新变更补齐偏差。

解决方案 #

• 临时修复：所有遇到412 Precondition Failed etag不匹配错误的请求，先调用events.get接口拉取对应事件的最新etag，更新本地存储的etag后再重试即可恢复同步链路。
• 规避方案：在执行「普通事件转全天事件」操作后，增加2-3秒的等待窗口再执行后续的事件修改操作，避开后端异步校准的并发时间窗。
• 通用适配：给所有带etag校验的patch请求增加最多2次的重试逻辑，触发412错误时自动拉取最新事件信息刷新etag后重试，可覆盖这类后端隐性变更导致的etag偏差问题。

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