Shopware 6 API创建产品返回204后报编号重复但无产品记录问题

问题根因说明 #

• 首次请求返回204 No Content属于Shopware 6 API的默认正常响应：创建接口未指定返回参数时，创建成功默认返回空内容的204响应，不是请求失败，产品创建逻辑已经执行。
• 报编号重复但找不到产品的常见原因如下：
  1. 后台搜索索引未同步：Shopware后台全局产品搜索依赖MySQL全文索引或Elasticsearch索引，刚创建的产品未完成索引同步时无法通过全局搜索命中，可在产品列表使用产品编号精确筛选查找。
  2. 数据库查询方式错误：请使用精确匹配SQL查询产品主表确认，避免模糊搜索漏查：

  SELECT * FROM product WHERE product_number = '12345667891';
  

  3. 草稿功能占用唯一编号：如果实例开启了产品草稿功能，首次创建的产品会作为未发布草稿存入product_draft表，不会同步到主产品表也不在后台展示，但会提前占用productNumber的唯一约束，导致二次提交报错。
  4. 后置事件异常回滚：如果有自定义插件监听了产品写入事件，事件执行时抛出异常被捕获，会导致产品创建事务回滚，主表无数据，但唯一约束校验已经触发，出现编号占用的异常。

解决方法 #

• 优先调用API查询产品状态，结果比后台搜索和手动查表更准确：

  GET /api/product?filter[productNumber]=12345667891
  

• 后续创建产品时请求添加_response=detail查询参数，接口会返回201状态码和完整的产品信息，替代默认的204响应，方便直接确认创建结果。
• 确认主表无对应产品后，可先调用DELETE接口删除对应编号的资源，再重新提交创建请求即可。

内容的提问来源于stack exchange，提问作者Grimclaw Draven