Shopify 商品匯入錯誤「Invalid CSV header: missing headers」的解決方法

這則錯誤代表什麼

商品 CSV 的第一列是標題列，Shopify 依欄位名稱的確切寫法辨識各欄位。如果缺少 Title、URL handle（舊版範本為 Handle）等必要欄位，或欄位名稱寫法不同，Shopify 就無法讀取檔案並會停止匯入。

常見原因

• 檔案來自其他平台，使用了自己的欄位名稱，例如用 Name 代替 Title。
• 編輯檔案時刪除了某個必要欄位。
• 欄位名稱多了空格、有錯字，或用詞與 Shopify 範本不同。

解決方法

1. 下載 Shopify 的商品 CSV 範例檔案，或從商店匯出一項商品，查看正確的欄位名稱。
2. 把檔案的第一列與範例檔案逐欄比對。
3. 改正寫法不一致的欄位名稱，並補上缺少的必要欄位。
4. 刪除每個欄位名稱前後的空格。
5. 以 CSV UTF-8 格式儲存，然後重新匯入。

範例

Handle,Name,Price
wool-scarf,Wool scarf,24.90

URL handle,Title,Price
wool-scarf,Wool scarf,24.90

Name 不是 Shopify 的欄位名稱。改成 Title，並把 Handle 改成 URL handle，就與目前的範本一致了。

如何避免

• 新檔案請從 Shopify 範本或最新的匯出檔案開始，不要手動拼寫欄位名稱。
• 使用會把每個欄位名稱與 Shopify 新舊兩版欄位名稱比對的檢查工具。

常見問題

還能使用 Variant Price 這類舊版欄位名稱嗎？

Shopify 仍接受舊版範本的檔案，但同一個檔案裡的欄位名稱要統一使用同一版。新舊欄位名稱混用可能導致欄位被辨識錯誤。

匯入時跳出的「Choose column headings」視窗是什麼？

欄位名稱不相符時，Shopify 會顯示這個視窗，你可以在裡面手動對應每個欄位。但直接修正檔案中的欄位名稱，對日後的匯入更可靠。

Skuvera 中的相關檢查

• 缺少 Title 欄位
• 缺少 URL handle 欄位
• 無法辨識的欄位

其他匯入錯誤

• 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 CSV 匯入錯誤「Network error: Unexpected token < in JSON at position 0」的解決方法
• Shopify CSV 匯入錯誤