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 檢查參照時它還沒有被建立。
- 被參照的商品已從商店中刪除。
- 參照值有錯字,或與任何既有商品都不相符。
解決方法
- 先儲存一份檔案副本,保留中繼欄位的值。
- 在要匯入的檔案中,清空商品參照類中繼欄位中的值。
- 匯入檔案,所有商品都會先在沒有參照的情況下建立。
- 把中繼欄位的值還原到 CSV 中。
- 勾選「Overwrite products with matching handles」再次匯入。此時被參照的商品都已存在,參照就能被接受。
如何避免
- 先匯入新商品,再匯入任何參照它們的檔案。
- 依 Shopify 的建議,把含有參照的匯入分成兩個階段進行。
常見問題
- 為什麼要匯入兩次?
- Shopify 在匯入每項商品時檢查它的參照。同一檔案中稍後才建立的商品,在那個時間點還不存在,所以第一次匯入用來建立商品,第二次再加上參照。
- 覆寫選項會改動其他資料嗎?
- 它會用 CSV 中包含之欄位的值,取代 handle 相同之商品的對應資料。檔案中沒有的欄位會保留原本的值。
了解更多
查看 Shopify 官方說明其他匯入錯誤
- Shopify CSV 匯入錯誤「Validation failed: price can't be blank」的解決方法
- Shopify CSV 匯入錯誤「Validation failed: options are not unique」的解決方法
- 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 匯入錯誤
更新於 2026年10月30日
Skuvera