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,常見於標題相近的商品。
  • 合併了多份匯出檔案,同一商品出現了兩次。

解決方法

  1. 在錯誤訊息中找到對應的 handle。
  2. 在檔案中搜尋所有帶有這個 handle 的列。
  3. 如果這些列屬於同一商品,把它們移到一起,上下相鄰。
  4. 如果屬於不同商品,替其中一項換一個不重複的 URL handle,只使用小寫英文字母、數字和連字號。
  5. 如果同一商品出現了兩次,刪除重複的列。
  6. 以 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,特別是合併檔案之後。

匯入前就發現這個問題

Skuvera 在瀏覽器中依 Shopify 的全部規則檢查你的商品 CSV,並指出具體的列與欄。免費,無需註冊。

常見問題

這則錯誤會修改我商店中既有的商品嗎?
不會。這些列被略過了,其中的內容沒有匯入。修正檔案後重新匯入這些商品即可。
「Overwrite products with matching handles」是做什麼的?
勾選後,CSV 中的商品會覆寫商店裡 handle 相同的既有商品。它無法解決檔案內部 handle 重複的問題。

Skuvera 中的相關檢查

查看 Shopify 官方說明

其他匯入錯誤

更新於 2026年10月30日