Shopify CSV 匯入錯誤「Validation failed: Value must be a valid product reference」的解決方法

CSV 中的某個中繼欄位參照了商店裡還不存在的商品。先在不填這些中繼欄位值的情況下匯入商品,再把值補回去,勾選「Overwrite products with matching handles」重新匯入。

Shopify 顯示的錯誤訊息

Validation failed: Value must be a valid product reference

這則錯誤代表什麼

有些中繼欄位(例如相關商品、搭配商品)儲存的是對另一項商品的參照。Shopify 只接受對商店中已存在之商品的參照。如果被參照的商品是由同一個 CSV 建立的,或根本不存在,匯入就會以這則錯誤失敗。

常見原因

  • 被參照的商品在同一個檔案中,Shopify 檢查參照時它還沒有被建立。
  • 被參照的商品已從商店中刪除。
  • 參照值有錯字,或與任何既有商品都不相符。

解決方法

  1. 先儲存一份檔案副本,保留中繼欄位的值。
  2. 在要匯入的檔案中,清空商品參照類中繼欄位中的值。
  3. 匯入檔案,所有商品都會先在沒有參照的情況下建立。
  4. 把中繼欄位的值還原到 CSV 中。
  5. 勾選「Overwrite products with matching handles」再次匯入。此時被參照的商品都已存在,參照就能被接受。

如何避免

  • 先匯入新商品,再匯入任何參照它們的檔案。
  • 依 Shopify 的建議,把含有參照的匯入分成兩個階段進行。

檢查檔案中的其他問題

Skuvera 無法在匯入前發現這一類問題,但它會在瀏覽器中依 Shopify 的其他規則檢查你的商品 CSV,幫你一次修正其餘問題。免費,無需註冊。

常見問題

為什麼要匯入兩次?
Shopify 在匯入每項商品時檢查它的參照。同一檔案中稍後才建立的商品,在那個時間點還不存在,所以第一次匯入用來建立商品,第二次再加上參照。
覆寫選項會改動其他資料嗎?
它會用 CSV 中包含之欄位的值,取代 handle 相同之商品的對應資料。檔案中沒有的欄位會保留原本的值。

了解更多

查看 Shopify 官方說明

其他匯入錯誤

更新於 2026年10月30日