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 匯入錯誤