台灣小工具研究室
CSV error dictionary

商品 CSV 匯入錯誤訊息對照表:先看哪個欄位最可能壞掉

平台常只丟一句「欄位格式錯誤」或「部分資料匯入失敗」,但真正的問題可能在表頭、商品名稱、SKU、價格、圖片網址或換行。這份對照表先幫你把錯誤訊息翻成可檢查的欄位。

先不要整份重做: 把失敗列切成 3 到 5 列小檔,再按下面的「優先檢查」欄位逐項排查。若懷疑有看不見的空白或特殊字元,先用 平台字元安全檢查器
想先看完整包長什麼樣: 下載 CSV 上架救援智能體包免費 sample。Sample 只放前 5 條錯誤、壞 CSV 前後對照與一段 AI 追問示範;完整包會把「錯誤訊息 -> 欄位定位 -> 清理公式 -> 5 列驗收」整理成可重複交付的流程。

錯誤訊息對照表

錯誤訊息或症狀 優先檢查 可能原因 下一步
欄位格式錯誤 表頭、價格、庫存 表頭多空白、價格含幣別、庫存不是整數。 切 5 列小檔,先清表頭與數字欄。
找不到必要欄位 第一列表頭 欄名被改、全形空白、範本版本不一致。 下載平台最新範本,不手打欄名。
商品名稱格式錯誤 商品名稱 Emoji、換行、智慧引號、零寬字元。 先做字元檢查,再看標題長度。
SKU 重複 SKU 同款規格沒有尾碼,或前後空白造成假重複。 清空白後排序查重。
SKU 更新不到商品 SKU 與平台匯出檔 全形英數、大小寫不一致、平台原 SKU 被改。 以平台匯出的現有商品檔為準。
價格格式錯誤 價格欄 含 NT$、逗號、元、促銷文案或小數格式不合。 只留平台允許的數字格式。
CSV 亂碼 檔案編碼 不是 UTF-8、另存格式不合、BOM 問題。 另存 UTF-8 CSV,先匯入小檔。
欄位數量不一致 逗號、換行、描述欄 欄位內有逗號或換行,CSV 引用不正確。 先清換行,描述欄另行檢查。
圖片網址無效 圖片欄 私有雲端連結、過期連結、網址含空白。 改用公開可讀圖片網址。
成功列數少於總列數 失敗列報告 只有部分列混入特殊欄位或資料格式不合。 抽失敗列做小檔,逐欄排查。

最短排查順序

  1. 備份原始 CSV。
  2. 只留下表頭與 3 到 5 列失敗資料,另存小檔。
  3. 先查表頭,不要先改商品內容。
  4. 再查商品名稱、SKU、價格、圖片網址。
  5. 小檔成功後,再套用到完整檔。

什麼時候該用智能體包?

如果你每次匯入都會遇到不同錯誤,問題通常不是單一公式,而是缺一套固定排查流程。CSV 上架救援智能體包 把匯入救援、商品標題清理、SKU/價格欄檢查與活動毛利檢查拆成可重複使用的提示詞與樣本資料。

下一步: 先下載 免費 sample ZIP 看壞資料前後對照;再看 完整智能體包介紹。如果錯誤集中在 SKU,看 蝦皮商品 CSV 顯示 SKU 重複怎麼修?;如果是價格欄報錯,看 商品 CSV 價格格式錯誤怎麼辦?;如果只是單純空白或換行,看 Excel 全形空白怎麼移除?
廣告預留區:穩定 hosting 與內容量足夠後再啟用。