CSVインポートエラー解決
Shopify「Invalid CSV Header / ヘッダー行が不足または不正」と言われた時のチェックリスト
インポートの一番最初で Invalid CSV Header: Missing headers Handle と止まる、あるいは列がズレて読み込まれる──原因は(1) 必須列名の不一致か (2) 行ごとの列数のズレのどちらかです。順に潰せば必ず通ります。
チェック1：必須列名が正しいか
Shopify商品CSVで必須なのは Handle 列です。 スペルや余分なスペース、全角混じり、列名の前後の空白で認識されないことがあります。 バリアントを使う場合は Option1 Name / Option1 Value も必要です。
- 1行目（ヘッダ行）に Handle が正確にあるか。
- 列名の前後に余分なスペースが入っていないか（Handle ←末尾空白はNG）。
- 先頭にBOMが付いて Handle が認識されていないか（→ 文字コードの記事）。
- 迷ったらShopify公式のサンプルCSVをテンプレにして、自分のデータを流し込む。
チェック2：列数のズレ（Excelのクォート崩れ）
「ヘッダは合っているのに途中で失敗する」場合、原因は行ごとの列数のズレです。 多くは、カンマや改行を含むフィールド（商品説明文など）を囲うダブルクォートが Excelの保存で壊れ、1つのセルが複数列に割れてしまうことで起きます。
Handle,Title,Body mug,マグカップ,"容量は350ml、電子レンジ対応 ← クォートが閉じていない （次の行が前のセルに飲み込まれて列数が崩れる）
- カンマ・改行・ダブルクォートを含むフィールドは "..." で囲い、内側の " は "" と二重にする。
- 各行のカンマの数がヘッダ行と同じか確認する（列数一致）。
- 空白行を途中に挟まない（取込でエラー/スキップの原因）。
- 行末の余分なスペースも弾かれる原因になる。
無料プリフライトは、CSVをRFC4180準拠で解析し、ヘッダと列数が一致しない行・ 未閉クォートの位置・Handle欠落行を行番号で列挙します。 目視で探す数十分が数秒になります。完全ブラウザ内・アップロード無し。
壊れ行を特定する →よくある質問
列名は合っているのに「ヘッダー不足」と出ます。
ファイル先頭にBOM（不可視の3バイト）が付き、最初の「Handle」が別物として読まれている可能性が高いです。UTF-8（BOMなし）で保存し直してください。
スプレッドシートでは正常に見えるのに弾かれます。
表計算アプリは壊れたクォートを“いい感じ”に表示してしまいます。生のテキストとして開く（またはツールに通す）と、未閉クォートや列数ズレが見えます。
ファイルが大きくて手で探せません。
本ツールは行単位で問題箇所を列挙するので、行数が多くても該当行だけ直せます。