指南
V001

Shopify CSV “验证失败:选项不唯一”:如何修复

在一个产品句柄下查找具有相同 Option1–3 值组合的两个变体行。不要更改每个重复的句柄:一种产品的变体通常共享它。

規則定義

同一 Handle 下的變體重複使用相同選項組合。

嚴重

自動修正範圍: 此規則需要手動複核;工具不會自動修改業務資料。

不要發明新的選擇權價值
如果此 CSV 更新现有产品,则更改选项值可能会创建新的变体 ID 并影响依赖它们的应用程序。編輯前請確認您商店中的預期變體。

該錯誤意味著什麼

Shopify 表示該檔案可能包含一種產品的重複選項,或同一產品可能出現在同一句柄下的其他位置。比較完整的選項組合,而不僅僅是一種尺寸或顏色單元格。真正的變體行上預計會出現重複的句柄。

兩行,一個 Size 值

以下兩行都屬於手把 T 卹並解析為 Size: M 選項組合。在窄螢幕上,橫向捲動程式碼區塊可查看所有列。

無效:重複的選項組合
Title,URL handle,Option1 name,Option1 value
Tee,tee,Size,M
,tee,,M

規則 V001 標記兩個業務行。連續行上的空白 Title 和 Option1 名稱不會使 M 成為不同的變體。

說明性更正:兩種不同的尺寸
Title,URL handle,Option1 name,Option1 value
Tee,tee,Size,M
,tee,,L

僅當第二行確實描述大小 L 時才使用 L。否則,請在檢查來源資料後刪除真正重複的行或修正產品對應。

如何安全調查

  1. 01

    保留原來的 CSV。按 URL 句柄將資料行分組,然後比較每個產品中的每個非空 Option1、Option2 和 Option3 值。

  2. 02

    檢查重複的行是否為不同的預期變體、意外重複的產品行或僅影像的連續行。重複的句柄本身並不是重新命名產品的理由。

  3. 03

    修正實際來源錯誤:為真實變體提供其真實選項值,僅刪除已確認的重複項,或者如果它屬於其他產品,則使用正確的句柄。

  4. 04

    再次執行本機檢查,查看其他結果,並在匯入之前驗證 Shopify 中現有變體的任何變更。

在本地尋找重複的組合

目錄預檢查規則 V001 報告同一手柄下重複的非空 Option1-3 組合。它忽略僅圖像行。它無法確定哪一行是正確的,也無法查看商店中已有的變體。返回開啟一個新的驗證器;先前選擇的檔案不會被保留。
尚不確定的事情
乾淨的檔案層級掃描並不能證明 CSV 與現有的 Shopify 變體相符或匯入會成功。在更改現有產品上的選項之前,請查看預期的產品和變體 ID。

資料來源檢查:2026 年 9 月 28 日。 Shopify:常見導入問題 · Shopify:產品 CSV 選項與型號 ID

Catalog Precheck 是一個獨立的工具,不隸屬於 Shopify。