Catalog Precheck

Shopify CSV 提示“Validation failed: options are not unique”怎么办

检查同一商品 Handle 下，是否有两条变体记录使用完全相同的 Option1–3 值组合。不要把每个重复 Handle 都改掉：同一商品的变体本来就会共用它。
不要凭空编造新的选项值
如果 CSV 用于更新现有商品，修改 Option 值可能生成新的变体 ID，并影响依赖这些 ID 的应用。编辑前先在商店确认该变体的真实含义。

这个错误是什么意思

Shopify 提示同一商品可能有重复选项，也可能是同一 Handle 的商品在 CSV 别处重复出现。需要对照完整选项组合，不能只看某一个尺码或颜色单元格。真正的变体行共用 Handle 是正常的。

两条记录使用同一尺码

下方两行都属于 tee，且都对应 Size: M 选项组合。窄屏下可横向滚动代码块查看全部列。

错误：选项组合重复

Title,URL handle,Option1 name,Option1 value
Tee,tee,Size,M
,tee,,M

V001 会报告这两条业务记录。续行中的 Title 和 Option1 name 留空，不会让第二个 M 变成不同变体。

示意修正：两个不同尺码

Title,URL handle,Option1 name,Option1 value
Tee,tee,Size,M
,tee,,L

只有第二行确实是 L 码时才写 L；否则应核对来源数据，删除确认重复的记录，或修正商品对应关系。

如何谨慎排查

  1. 保留原始 CSV。按 URL handle 分组，在每个商品内比较 Option1、Option2、Option3 的非空值组合。
  2. 确认重复行是不同的真实变体、误复制的商品行，还是仅用于图片的续行。不能只凭重复 Handle 就重命名商品。
  3. 修正真正的来源错误：填写真实选项值、只删除确认重复的记录，或在确属其他商品时使用正确 Handle。
  4. 重新本地检查，复核其他问题；如果涉及已有变体，导入前还要在 Shopify 核实可能的 ID 变化。

在本地找出重复组合

Catalog Precheck 的 V001 规则报告同一 Handle 下重复的非空 Option1–3 组合，并忽略纯图片续行。工具无法决定哪一行正确，也看不到商店已有变体。

检查我的 CSV查看 V001 规则

仍然无法确定的部分

文件层面的检查通过，不代表 CSV 与 Shopify 已有变体一致或导入一定成功。改变现有商品选项前，应核实目标商品和变体 ID。

来源核对日期：2026 年 9 月 28 日。 Shopify：常见导入问题 · Shopify：商品 CSV 选项与变体 ID

Catalog Precheck 是独立工具，与 Shopify 无隶属关系。