CSVエラーガイド

最終更新日: 2026-03-30

はじめに

CSVをデータベースにインポートしたり、別システムと連携したりする際、文字化け・重複ID・見えない文字などが原因でエラーになることがあります。このガイドでは、代表的なCSVエラーの種類と対処法を説明し、CSVチェッカーでの検出・修正の流れも紹介します。

クイックチェック: 取り込みが失敗する原因

CSVが「見た目は問題ないのに」取り込みに失敗する時は、まずこのチェックリストを上から確認してください。多くは数分で原因を特定できます。

• 区切り文字の不一致: カンマ想定なのにタブ/セミコロン（または逆）。
• 文字コードの不一致: ExcelがShift_JIS等で保存し、取り込み側がUTF-8を期待している（または逆）。
• BOM/ヘッダー問題: UTF-8 BOM、ヘッダー重複、ヘッダー行がデータ中に再登場。
• 列数のズレ: 一部行だけカンマ不足/過多（引用符の崩れ、テキスト内カンマの未処理）。
• 改行コード: CRLF/LFの混在で厳格なパーサーが失敗する。
• 不可視文字: ゼロ幅スペース、NBSP、タブ、制御文字など。
• 前後空白: “ID” と “ID ” が別扱いになり、マッチング/一意制約が崩れる。
• 重複ID: ユニークキー列に重複値がある。
• 引用符フィールド: 引用符が閉じていない、引用ルールが不統一でパースエラー。
• 型の期待違い: 日付/小数点がロケール表記で、検証で弾かれる。

最短ルート: まず 形式・基本チェック（文字コード/区切り/列/BOM）→ 次に 単体チェック（重複/不可視文字/空白）を確認。文字化けしている場合は 文字化け復元 から始めるとスムーズです。

実務ケース: 10分で原因を切り分ける

ケースA. ブラウザでは正常だが Excel で文字化け

症状: 画面プレビューは正常なのに、Excelで開くと文字化けする。

原因: 元ファイルが UTF-8（BOMなし）で、Excel がローカル文字コードとして解釈。

対処: 文字化け復元で UTF-8（BOM付き）に変換して再度開く。

ケースB. DB取り込みでユニークキー違反

症状: 取り込み時に duplicate key エラーが出る。

原因: ID列の重複値に加え、一部のキーに前後空白が混在。

対処: 単体チェックで重複検出と空白トリムを実行し、重複行を整理して再取り込み。

ケースC. 見た目が同じ値なのに一致しない

症状: 検索・突合で不一致になるが、見た目では同じ文字列。

原因: ゼロ幅スペースや NBSP など不可視文字が混入。

対処: 不可視文字を一括除去し、比較画面で再確認する。

1. 文字化け（エンコーディングの不一致）

原因

CSVがShift_JISやEUC-JPで保存されているのに、UTF-8として開いたり、その逆の組み合わせで開いたりすると文字化けします。Excelで「CSV UTF-8」で保存していない場合、多くの環境ではShift_JIS（CP932）で保存されます。

対処法

• 元の文字コードを正しく検出し、UTF-8（必要ならBOM付き）に変換してから使う。
• 当サイトの文字化け復元ツールでは、ブラウザ内で文字コードを自動検出し、UTF-8 BOMでダウンロードできます。サーバーにファイルを送る必要はありません。

詳しくは文字化け・エンコーディングのトラブルを参照してください。

2. 重複ID

原因

主キーやユニークキーとして使う列（ID・メールアドレスなど）に、同じ値が複数行あると、DBの一意制約違反やマージ時の意図しない上書きの原因になります。手入力や別システムからの取り込みで重複が混入することがあります。

対処法

• インポート前に、キー列の重複をチェックする。
• CSV単体チェックでは「重複ID」を検出し、該当行を一覧で確認できます。手動で修正するか、重複を許容する設計にするかは業務に合わせて判断してください。

重複データの見つけ方・考え方は重複データガイドにまとめています。

3. 不可視文字・制御文字

原因

他のアプリやWebページからコピーしたデータには、ゼロ幅スペース・全角スペース・タブ・改行コードなど、見た目では分からない文字が含まれることがあります。これらは検索や比較で「同じはずなのに一致しない」という現象を引き起こします。

対処法

• 不可視文字を検出し、削除または正規化する。
• CSVチェッカーの単体チェックでは「見えない文字」を検出し、一括修正で除去できます。前後の空白トリムとあわせて実行すると、データの統一性が高まります。

4. 列数不一致・空行

原因

行によって列の数が違う（カンマの数が足りない・多い）と、パーサーやインポートツールがエラーを出すことがあります。また、空行が混ざっていると「ヘッダーとデータの対応がずれる」と誤認される場合もあります。

対処法

CSV形式・基本チェックで、列数不一致の行数や空行の有無を確認できます。該当行を特定したうえで、元データを修正するか、インポート時に「空行をスキップ」などのオプションで対処してください。

5. ヘッダー重複

ヘッダー行と同じ内容の行がデータ中にあると、列の意味づけが曖昧になります。基本チェックで「ヘッダー重複」の有無を確認し、必要なら該当行を削除または修正しましょう。

CSVチェッカーでの確認の流れ

1. 形式・基本チェック（inspect）：1つのCSVをアップロードし、文字コード・区切り文字・行数・列数不一致・空行・ヘッダー重複を確認。
2. 単体チェック（check）：不可視文字・重複ID・前後の空白を検出し、一括修正してからダウンロード。
3. 文字化けしているファイルは、先に文字化け復元（encoding-fix）でUTF-8 BOMに変換してから、上記のチェックを行うとスムーズです。

トップへ戻る · CSVチェックを始める