关于通过Shopware Sync API批量更新百万级产品的优化方案咨询

一、直接通过产品编号实现Upsert的官方方案 #

Shopware Sync API支持通过**产品编号（productNumber）**作为唯一匹配键实现Upsert，无需提前查询UUID。具体操作如下：

• 请求的action指定为upsert，同时通过identifier参数明确用productNumber作为匹配字段
• payload中只需包含productNumber和需要更新/创建的产品字段即可

示例请求结构：

{
  "action": "upsert",
  "entity": "product",
  "payload": [
    {
      "productNumber": "SKU12345",
      "name": "Updated Product Name",
      "price": [{"gross": 99.99, "net": 80.00, "currencyId": "b7d2554b0ce847cd82f3ac9bd1c0dfca"}]
    }
  ],
  "identifier": "productNumber"
}

API会自动根据productNumber匹配产品：存在则更新，不存在则创建，彻底省去逐个查询UUID的步骤。

二、百万级数据提速关键优化 #

针对大规模数据同步，单条请求效率极低，必须做以下优化：

• 批量提交：每次Sync请求批量处理50-100个产品（根据服务器性能调整），减少HTTP请求的开销
• 异步处理：添加async: true参数启用异步Sync，避免同步请求超时，后续通过返回的syncId查询处理状态
• 索引确认：确保Shopware数据库中product.product_number字段有唯一索引（默认已存在，需确认未被修改），这能大幅提升产品匹配的查询速度

三、自定义UUID方案的风险提示 #

你提出的基于产品编号MD5哈希生成UUID的思路，理论可行但不建议落地：

• 编号变更风险：若ERP修改产品编号，会导致UUID与Shopware系统内的标识不匹配，后续无法关联产品数据
• 系统兼容性：Shopware的UUID是核心关联标识，自定义生成可能破坏分类、库存、订单等关联数据的逻辑
• 维护成本：自定义UUID会增加后续数据排查的难度，不符合Shopware原生设计规范

内容的提问来源于stack exchange，提问作者Ole Dahl Mansfeld