专项排查 · 2026 年 9 月 24 日

WooCommerce 提示 SKU 已存在,或跳过了 CSV 商品行?

先确认这次导入要新建商品,还是更新店铺已有商品;再分别检查 CSV 文件和店铺数据,不要急着修改商品标识。

先说结论

“重复”可能指两种不同情况。

同一个 SKU 可能在 CSV 中出现两次,也可能与 WooCommerce 店铺中的现有商品相同。只看文件能发现第一种情况;要确认第二种,需要店铺导出和导入日志。勾选“更新现有商品”后,WooCommerce 会用 ID 或 SKU 匹配现有商品。

保存导入日志,先备份店铺,并保留一份未修改的商品导出。不要为了消除报错随意更换生产环境的 SKU:订单、库存同步和其他集成可能依赖它。

如果文件在处理商品行之前就被拒绝,请先查看 WooCommerce CSV 综合故障清单(英文)。

四种情况

根据失败行选择处理方式。

01
现象

店铺中已有相同 SKU

CSV 行的 SKU 相同,不代表新建导入会自动变成更新操作。

下一步: 如果本来要修改该商品,先导出当前商品行,再检查“更新现有商品”选项;如果确实是新商品,应使用独有的 SKU。

02
现象

文件中两行使用同一 SKU

商品或变体需要明确且唯一的标识;文件内重复 SKU 需要人工判断。

下一步: 确认两行描述的是同一商品、不同商品,还是不同变体。保留正确的商品标识,不要机械地给每个重复值加数字。

03
现象

更新模式跳过未匹配的行

WooCommerce 更新现有商品时按 ID 或 SKU 匹配;普通商品行未匹配时通常会被跳过。

下一步: 将该行与此店铺最新的导出结果对照。修正要匹配的 ID 或 SKU;真正的新商品应另行用新建模式导入。

04
现象

变体被跳过或关联到错误的父商品

变体需要自身的标识,Parent 字段也必须指向预期的可变商品。

下一步: 检查父商品 SKU 或 id:123 引用、每个变体的 SKU 和属性值。更新模式下新变体行的处理取决于 WooCommerce 版本及该行满足的条件。

工具能力边界

本地检查无法看到你的店铺数据。

上传前可检查
  • CSV 文件内部重复的 SKU
  • 缺失标识和常见的行结构问题
需在 WooCommerce 中核对
  • 店铺已有的 ID 和 SKU
  • 导入模式、列映射及被跳过行的日志
  • 当前安装版本创建变体的具体规则

免费扫描只在你的浏览器中运行,不连接 WooCommerce,也不会代你决定已有 SKU 应更新哪件商品。

安全复测

先用小批量确认模式和商品标识。

  1. 01
    保留原件

    备份店铺,保存日志和最新商品导出。

  2. 02
    分类

    区分文件内部重复与店铺中已有的 SKU。

  3. 03
    选择模式

    确认新建或更新,并复核列映射。

  4. 04
    小量测试

    条件允许时,在测试站导入一两条代表性记录。

  5. 05
    核验结果

    检查商品、变体、价格、库存和导入日志,再扩大范围。

官方资料(英文)

以当前导入器规则为准。

WooCommerce:商品 CSV 导入与导出 WooCommerce:商品设置中的 SKU 唯一性 WooCommerce:更新导入时处理变体行

需要限定范围的修复?

先描述失败行,不要发送客户数据。

请提供报错文字、大致行数,以及本次属于新建还是更新。文件传输前,我们会先确认范围和价格。文件内部的重复值清理可能适合快速修复;涉及店铺现有商品标识的决定则需要单独评估。

提交询价