Shopify CSV 导入报错 “Validation failed: options are not unique” 的解决方法

这个报错是什么意思

Shopify 通过选项值的组合（Option1 value、Option2 value、Option3 value）区分每个变体。同一商品内，任意两个变体的组合都不能相同。发现重复的组合时，Shopify 会以这个报错拒绝导入该商品。

常见原因

• 复制了一个变体行，但没有修改它的选项值。
• 两个不同的商品使用了相同的 URL handle，Shopify 把它们的行当成同一商品的变体。
• 选项值只在空格或大小写上不同，例如“M”和“M ”，Shopify 会把它们视为同一个值。

解决方法

1. 在报错信息中找到对应的商品，查看所有带这个 URL handle 的行。
2. 比较每一行的 Option1、Option2、Option3 值，找出组合相同的行。
3. 如果是真正的重复，删除多余的那一行；如果是不同的变体，修改它的选项值，例如把 White 改成 Black。
4. 如果是两个不同商品共用了 handle，给其中一个换一个唯一的 URL handle。
5. 以 CSV UTF-8 格式保存，然后重新导入。

示例

URL handle,Title,Option1 name,Option1 value,Option2 name,Option2 value,Price
linen-shirt,Linen shirt,Size,M,Color,White,39.00
linen-shirt,,,M,,White,39.00

URL handle,Title,Option1 name,Option1 value,Option2 name,Option2 value,Price
linen-shirt,Linen shirt,Size,M,Color,White,39.00
linen-shirt,,,M,,Black,39.00

两个变体都是 M / White。把第二个改成 Black 后，每种组合都只出现一次。

如何避免

• 复制一份文件，按 URL handle 和选项值排序，方便发现重复的组合。
• 使用会检查每个商品选项组合的校验工具，它也能发现只差空格或大小写的重复。

常见问题

只有一个变体的商品也需要选项值吗？

单一变体的商品可以把选项名写成 Title、选项值写成 Default Title。只有多变体的商品才需要不同的选项值。

修改选项值会影响已有的变体吗？

会。Shopify 说明，修改 Option1、Option2 或 Option3 的值会删除已有的变体 ID 并创建新的 ID，依赖变体 ID 的应用或集成可能因此失效。

Skuvera 中的相关检查

• 变体重复

其他导入报错

• Shopify CSV 导入报错 “Validation failed: price can't be blank” 的解决方法
• Shopify CSV 导入报错 “Ignored line because handle already exists” 的解决方法
• Shopify CSV 导入报错 “Ignored line because it did not contain product data” 的解决方法
• Shopify 商品导入报错 “Invalid CSV header: missing headers” 的解决方法
• Shopify CSV 导入报错 “Network error: Unexpected token < in JSON at position 0” 的解决方法
• Shopify CSV 导入报错