Shopify CSV 匯入錯誤「Ignored line because handle already exists」的解決方法
這一列的 URL handle 已經被檔案中前面的商品用過,所以 Shopify 略過了它。讓同一商品的所有列連續排列,並確保不同商品不共用同一個 handle。
Shopify 顯示的錯誤訊息
Ignored line #-## because handle example already exists
這則錯誤代表什麼
URL handle 是每項商品的唯一識別碼。Shopify 由上而下讀取檔案,把相鄰且 handle 相同的列歸為同一商品。如果同一個 handle 在另一項商品之後再次出現,或第二項商品使用了已經用過的 handle,Shopify 就會忽略這些列。
常見原因
- 在試算表中依 URL handle 以外的欄位排序,把同一商品的列拆散了。
- 兩項不同的商品被設定了相同的 handle,常見於標題相近的商品。
- 合併了多份匯出檔案,同一商品出現了兩次。
解決方法
- 在錯誤訊息中找到對應的 handle。
- 在檔案中搜尋所有帶有這個 handle 的列。
- 如果這些列屬於同一商品,把它們移到一起,上下相鄰。
- 如果屬於不同商品,替其中一項換一個不重複的 URL handle,只使用小寫英文字母、數字和連字號。
- 如果同一商品出現了兩次,刪除重複的列。
- 以 CSV UTF-8 格式儲存,然後重新匯入。
範例
URL handle,Title,Option1 name,Option1 value,Price cotton-tee,Cotton tee,Size,S,25.00 linen-shirt,Linen shirt,Size,S,39.00 cotton-tee,,,M,25.00
URL handle,Title,Option1 name,Option1 value,Price cotton-tee,Cotton tee,Size,S,25.00 cotton-tee,,,M,25.00 linen-shirt,Linen shirt,Size,S,39.00
cotton-tee 的 M 尺寸列排在 linen-shirt 之後,被 Shopify 忽略了。把它移到 cotton-tee 第一列的正下方即可。
如何避免
- 不要在試算表中對商品 CSV 排序。Shopify 提醒,排序也可能讓圖片和商品脫離對應關係。
- 匯入前檢查是否有重複的 handle,特別是合併檔案之後。
常見問題
- 這則錯誤會修改我商店中既有的商品嗎?
- 不會。這些列被略過了,其中的內容沒有匯入。修正檔案後重新匯入這些商品即可。
- 「Overwrite products with matching handles」是做什麼的?
- 勾選後,CSV 中的商品會覆寫商店裡 handle 相同的既有商品。它無法解決檔案內部 handle 重複的問題。
Skuvera 中的相關檢查
查看 Shopify 官方說明其他匯入錯誤
- Shopify CSV 匯入錯誤「Validation failed: price can't be blank」的解決方法
- Shopify CSV 匯入錯誤「Validation failed: options are not unique」的解決方法
- 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 匯入錯誤
更新於 2026年10月30日
Skuvera