全部 Shopify CSV 导入错误
Shopify

Shopify CSV “Default Title already exists”:排查变体

“Validation failed: The variant 'Default Title' already exists” 可能指向默认变体或选项数据冲突。修改选项前核对整个商品组及店铺现有变体。
资料核对日期:2026 年 10 月 1 日。示例为合成字段子集,不是店铺导出文件,也不保证导入成功。
当前本地校验器能检测什么
V002 检测变体字段缺少 Option1 依赖;V001 检查非默认选项组合重复。两者都不检测店铺现有冲突或重复的字面 Default Title 组合。

错误可能发生的原因

包含变体数据却缺少匹配选项的行,会让预期变体不明确。Shopify 客服建议检查 Option1 name 和 Option1 value;没有选项的商品具有默认变体,店铺现有数据也可能影响结果。

需要核对的字段和行

按 URL handle 分组,核对 Option1 name、Option1 value 及每个变体的 SKU。变体和图片行重复 handle 属正常情况,不应因此重命名商品。

问题与修正示例

第 1 条记录是表头。下面的小示例只展示相关字段;实际导入仍需保留其他必要字段。代码块可横向滚动。

问题示例
Title,URL handle,Option1 name,Option1 value,SKU
Example tee,example-tee,,,TEE-S
,example-tee,,,TEE-M

第 2、3 条记录有 SKU,但缺少选项名称和值。V002 会报告依赖缺失,这不证明 Shopify 一定会输出相同的 Default Title 报错。

示意修正
Title,URL handle,Option1 name,Option1 value,SKU
Example tee,example-tee,Size,S,TEE-S
,example-tee,,M,TEE-M

仅当实际变体确实是 Size S 和 M 时采用该修正;续行可沿用首行的 Option1 name。修正字段子集通过本地检查,但店铺冲突仍无法确定。

修正后小批量验证

  1. 01

    保留备份,从 Shopify 导出受影响商品,对比现有变体及选项。

  2. 02

    区分真实变体行、意外重复行和仅图片续行;仅图片行只保留 handle 与图片字段。

  3. 03

    为真实变体恢复正确选项名称和值。无选项商品只保留一个预期默认变体;不要虚构尺码或重命名 handle。

  4. 04

    本地检查后,在 Shopify 测试一个受影响商品及全部相关行,核对变体 ID、选项、SKU 和图片后再继续。

自动修复支持

仅支持手动复核。工具不删除默认变体、不去重业务行,也不重写选项;修改选项可能替换变体 ID 并影响关联应用。

规则定义

存在变体字段,但缺少必需的 Option1 名称或值。

严重

自动修复边界: 此规则只报告给用户手动复核;工具不会自动修改相关业务数据。

在本地检查已修改的 CSV

CSV 保留在浏览器中。检查可检测的问题后,仍需在 Shopify 小批量验证。返回会打开新的校验器,之前选择的文件和结果不会保留。

官方来源: Shopify:常见导入问题 · Shopify:商品 CSV 选项与变体 ID · Shopify Community:默认变体问题的客服回复