API 2026-10 改了 created_at 比较,增量同步会漏单
不带毫秒的 created_at:> 从该秒的 .999999 起算,同一秒内后续订单会被静默跳过。
发生了什么#
开发者在 Shopify Community 报告:升级到 2026-10 后,`created_at:>` 过滤的语义变了。不带毫秒的时间值现在从该秒的 .999999 开始,因此 `created_at:>'2026-09-15T12:00:02Z'` 不再返回 12:00:02.500 创建的订单;而在 2026-07 及更早版本会返回。
关键细节#
- 只影响 `>`,不影响 `>=`、`<`、`<=`、纯日期值或已带毫秒的值
- 订单时间戳返回时被截断到秒,增量同步常把上一批的最大 createdAt 作为下一次的起点
- 旧行为是产生少量重复(可按 ID 去重),新行为变成静默缺口
- 官方建议改用 `>=` 并按 ID 去重
- 批量查询是否同样受影响,文档未明确说明,需要自行验证
对商家与开发者的影响#
升级后订单数会悄悄变少,而且缺口只发生在「同一秒内的后续订单」,抽查很难发现。
对账周期越长越难定位:等到月底发现少了订单,已经无法判断是哪一天漏的。升级前应先审计同步窗口与去重逻辑。
建议动作#
- 把 `created_at:>` 改成 `>=`,并用 ID 去重
- 保留 1–5 分钟的重叠窗口作为缓冲
- 升级后对比每日订单数与 Shopify 后台报表,连续观察一周
原文与编译说明
- 原文标题
- API 2026-10: created_at:> now skips orders from the rest of that second
- 发布来源
- Shopify Community
- 发布时间
- 2026-10-15
本文为中文编译摘要,包含站方补充的背景与影响分析,不是原文的逐字翻译。版权归原作者与发布方所有。若原文后续更新或信息有误,以官方页面为准;发现错误可发邮件到 admin@fgwljs.com 指出。
新闻栏目由 风格技术 技术团队维护,每个工作日筛选 Shopify 官方渠道与行业媒体的更新。功能是否可用,以店铺后台实际显示与官方文档为准。