Shopware 6 Webhooks未按预期触发：商品与分类关联事件异常

问题原因说明 #

• 在分类编辑页操作商品关联时，仅修改了category实体的关联关系集合，未改动product实体本身，因此不会触发product.written事件。
• 解绑商品时，若分类的其他字段无任何变更，Shopware的实体脏检查机制不会触发category.written事件，导致无Webhook通知。

可行解决方案 #

1. 监听product_category关联实体的Webhook事件 #

商品与分类的关联关系实际存储在product_category中间实体中，直接监听该实体的事件可覆盖所有关联变更场景：

• 配置Webhook时，添加product_category.written（捕获关联新增/修改）和product_category.deleted（捕获关联解绑）事件。
• 这类事件的Payload会直接包含productId和categoryId，能精准获取哪组关联发生了变化，示例Payload片段：

{
  "entity": "product_category",
  "action": "written",
  "primaryKey": "association-uuid",
  "payload": {
    "productId": "target-product-uuid",
    "categoryId": "target-category-uuid"
  }
}

2. 基于category.written事件的补充校验（仅适配新增场景） #

若暂时无法新增Webhook，可在收到category.written事件后，通过Shopware Admin API拉取分类的完整商品列表做对比：

• 调用GET /api/category/{categoryId}/products接口获取当前分类下的所有商品ID。
• 将返回的列表与本地缓存的分类旧商品列表对比，找出新增的商品ID。
• 注意：此方法无法检测解绑操作，因为解绑时不会触发category.written事件。

3. 自定义插件订阅内核事件（灵活定制） #

如果需要完全定制化的通知内容与时机，可开发Shopware插件订阅系统内核事件：

• 订阅ProductCategoryAddedEvent和ProductCategoryRemovedEvent这两个系统原生事件。
• 在事件处理逻辑中，组装包含商品ID、分类ID的自定义Payload，主动推送到前端的Webhook接收地址。
• 这种方式能完全控制通知的触发条件与内容，适配复杂业务场景。

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