Image filename check
商品圖片檔名有中文、空白或特殊符號會匯入失敗嗎？先查這 8 種字元
圖片網址明明可以打開，平台卻仍然說「圖片網址無效」、「主圖不得空白」或「圖片下載失敗」。如果公開權限、https 和圖片來源都沒問題，下一個常見原因就是檔名或網址路徑裡有平台不容易處理的字元。
先測一張圖：
把失敗圖片改成簡單檔名，例如
sku-a001-main.jpg，重新產生網址後只測 1 到 3 筆商品。若成功，問題通常就在原本檔名或網址編碼。
8 種高風險檔名字元
| 字元類型 | 例子 | 為什麼容易出錯 |
|---|---|---|
| 中文檔名 | 黑色洋裝主圖.jpg | 部分系統會轉碼，CSV 或平台讀取時可能變成亂碼。 |
| 半形空白 | product main.jpg | 網址裡需要編碼，複製貼上時容易被截斷。 |
| 全形空白 | product main.jpg | 肉眼難看出，平台可能當成不同字元或無效路徑。 |
| 括號 | A001(黑).jpg | 某些平台或工具會在轉換網址時處理不一致。 |
| 井字號 | A001#main.jpg | 網址中 # 後面常被當成頁面片段，不一定送到伺服器。 |
| 問號 | A001?main.jpg | ? 後面常被當成查詢參數，檔名會被切開。 |
| 百分比 | A001%20main.jpg | % 是網址編碼字元，錯誤組合會造成無效網址。 |
| 逗號或分號 | A001,main.jpg | CSV 或多圖欄位可能把它當成分隔符。 |
建議的圖片命名規則
商品圖片檔名不需要漂亮，重點是穩定、可追溯、平台容易讀。比較安全的做法是用商品 SKU 加圖片用途。
| 用途 | 建議檔名 | 備註 |
|---|---|---|
| 主圖 | a001-main.jpg | 只用小寫英數與連字號。 |
| 第二張圖 | a001-02.jpg | 用固定序號，方便排序。 |
| 規格圖 | a001-black-m.jpg | 顏色與尺寸用固定縮寫或英文。 |
| 情境圖 | a001-scene-01.jpg | 不要把完整中文描述塞進檔名。 |
30 分鐘排查流程
- 先選 3 筆失敗商品，保留原始圖片網址。
- 把圖片檔名改成英數、連字號與底線，不用中文和空白。
- 重新上傳圖片或重新產生公開圖片網址。
- 用無痕視窗打開新網址，確認不用登入且直接看到圖片。
- 只做 3 筆商品小檔匯入測試，先不要重傳整批商品。
檔名修好後還失敗，要看哪裡？
如果新檔名、新網址仍然失敗，下一步要查圖片尺寸、圖片格式、圖片欄是否空白、多圖分隔符，以及商品描述是否讓 CSV 欄位錯位。圖片錯誤訊息常常只是平台第一個報出來的問題，不一定代表只有圖片欄壞掉。
- 確認圖片格式是否為平台接受的 jpg、png 或 webp。
- 確認圖片尺寸是否太小、太大或比例不符合主圖要求。
- 確認圖片欄沒有換行、前後空白或全形空白。
- 確認多張圖片使用平台範本指定的分隔方式。
下一步：
把幾列商品資料貼到 商品資料免費健檢器，先查圖片網址、SKU、價格與欄位風險。若你需要一份修正 sample、欄位對照與 5 列驗收清單，可以看 商品資料健檢報告樣本，或填寫 商品資料健檢需求單。
本文是商品資料整理與圖片網址排查建議。實際圖片格式、檔名處理與匯入限制，請以你使用的平台最新範本和後台提示為準。
廣告預留區：內容量與審核條件足夠後再啟用。