Shopify CSV 导入报错 “Ignored line because handle already exists” 的解决方法

这一行的 URL handle 已经被文件中前面的商品用过,所以 Shopify 跳过了它。让同一商品的所有行连续排列,并确保不同商品不共用同一个 handle。

Shopify 显示的报错

Ignored line #-## because handle example already exists

这个报错是什么意思

URL handle 是每个商品的唯一标识。Shopify 从上到下读取文件,把相邻且 handle 相同的行归为同一商品。如果同一个 handle 在另一个商品之后再次出现,或者第二个商品使用了已经用过的 handle,Shopify 就会忽略这些行。

常见原因

  • 在表格软件中按 URL handle 以外的列排序,把同一商品的行拆散了。
  • 两个不同的商品被设置了相同的 handle,常见于标题相近的商品。
  • 合并了多份导出文件,同一商品出现了两次。

解决方法

  1. 在报错信息中找到对应的 handle。
  2. 在文件中搜索所有带这个 handle 的行。
  3. 如果这些行属于同一商品,把它们移到一起,上下相邻。
  4. 如果属于不同商品,给其中一个换一个唯一的 URL handle,只用小写字母、数字和连字符。
  5. 如果同一商品出现了两次,删除重复的行。
  6. 以 CSV UTF-8 格式保存,然后重新导入。

示例

修改前
URL handle,Title,Option1 name,Option1 value,Price
cotton-tee,Cotton tee,Size,S,25.00
linen-shirt,Linen shirt,Size,S,39.00
cotton-tee,,,M,25.00
修改后
URL handle,Title,Option1 name,Option1 value,Price
cotton-tee,Cotton tee,Size,S,25.00
cotton-tee,,,M,25.00
linen-shirt,Linen shirt,Size,S,39.00

cotton-tee 的 M 码行排在 linen-shirt 之后,被 Shopify 忽略了。把它移到 cotton-tee 第一行的正下方即可。

如何避免

  • 不要在表格软件里对商品 CSV 排序。Shopify 提醒,排序还可能让图片和商品脱离对应关系。
  • 导入前检查有没有重复的 handle,尤其是合并文件之后。

导入前就发现这个问题

Skuvera 在浏览器中按 Shopify 的全部规则检查你的商品 CSV,并指出具体的行和列。免费,无需注册。

常见问题

这个报错会修改我店铺里已有的商品吗?
不会。这些行被跳过了,其中的内容没有导入。修正文件后重新导入这些商品即可。
“Overwrite products with matching handles” 是做什么的?
勾选后,CSV 中的商品会覆盖店铺里 handle 相同的已有商品。它不能解决文件内部 handle 重复的问题。

Skuvera 中的相关检查

查看 Shopify 官方说明

其他导入报错

更新于 2026年10月30日