集合改为多来源模型，旧版本 API 会静默丢集合
集合支持多个 CollectionSource，旧版本查询无法表达新结构，会直接不返回这类集合。
发生了什么#
2026-07 版本把集合从单一 ruleSet 改成多来源模型：一个集合可以有多个 CollectionSource，每个来源有独立的包含与排除条件，匹配方式由 ANY 或 ALL 控制。问题在于旧版本 API 的结构无法表达新模型，Shopify 选择整体省略这些集合，而不是返回一个残缺对象。
关键细节#
- 每个 CollectionSource 可定义目标类型、匹配方式与条件列表
- Shopify Functions 增加变体级的集合归属字段
- 旧 ruleSet 结构无法表示多来源，旧版本查询会直接过滤掉这类集合
- 不报错、不警告，表现为「集合数量变少」或「集合查不到」
- 同步任务、集合选择器、B2B 目录限制逻辑都可能受影响
对商家与开发者的影响#
这是典型的静默故障：接口返回 200，数据结构正常，只是少了内容。依赖集合做商品范围控制的应用（尤其是 B2B 目录与折扣）可能因此放开或收紧错误的商品。
如果最近发现「后台有集合，API 里没有」，先确认版本是否低于 2026-07，再检查集合是否使用了新的 sources 结构。
建议动作#
- 把所有集合相关查询升级到 2026-07 或更高版本
- 用 sources 字段抽查使用新模型的集合是否返回完整
- 对依赖集合范围的折扣与目录做一次商品数量核对
原文与编译说明
- 原文标题
- The 2026-07 Collection model: silent breakage risk
- 发布来源
- Shopify 2026-07 release notes / 开发者分析
- 发布时间
- 2026-07-01
本文为中文编译摘要，包含站方补充的背景与影响分析，不是原文的逐字翻译。版权归原作者与发布方所有。若原文后续更新或信息有误，以官方页面为准；发现错误可发邮件到 admin@fgwljs.com 指出。
新闻栏目由 风格技术 技术团队维护，每个工作日筛选 Shopify 官方渠道与行业媒体的更新。功能是否可用，以店铺后台实际显示与官方文档为准。
