为何QuickBooks Online推荐使用Webhooks而非CDC？

QuickBooks Online的API文档建议优先使用webhooks而非change-data-capture（CDC）来同步实体数据，但webhooks存在不少明显弊端：

• 事件可能乱序到达
• 可能会遗漏事件
• 由于可能遗漏事件，仍需定期调用CDC
• 若应用长时间故障，Intuit可能将端点列入黑名单，导致需重新配置
• 必须快速响应，需使用队列和异步后台处理程序来处理更新

即便如此，webhooks依然是更优选择，核心原因在于实时性与资源效率：

1. 实时数据同步：CDC依赖定期轮询API获取变更，同步存在天然延迟；而webhooks能在数据变更发生时立即推送通知，让应用实现近乎实时的数据同步，这对需要及时响应业务变化的场景至关重要。

2. 减少API调用开销：CDC的轮询机制会产生大量无效请求（比如轮询时段无数据变更），既消耗Intuit的API调用额度，也增加应用的网络与处理成本。webhooks仅在有实际变更时触发通知，大幅降低了无效请求占比。

3. 长期维护成本更低：虽然webhooks需要处理乱序、遗漏等问题，但这些都有成熟的解决方案——比如通过事件ID排序、定期用CDC做补全校验、设置重试机制、用队列异步处理等。相比之下，CDC的轮询需要持续维护分页逻辑、增量数据筛选规则，长期复杂度并不比webhooks低。

4. 平台生态支持倾斜：Intuit将webhooks作为官方推荐方案，意味着后续会在该功能上投入更多优化（比如提升可靠性、扩充事件类型），而CDC的更新力度可能会逐步减弱。

内容的提问来源于stack exchange，提问作者In Hoc Signo