Web開発中に「JSON parse 失敗 原因」というキーワードで検索される場面は頻繁にあります。JSONが正しく解析されない原因は多岐にわたっており、一見正しそうな構造でも見落としがちです。この記事では、構文的ミス、エンコーディングの問題、サーバー応答の意図せぬ内容など、よくある原因を整理し、それぞれの確認ポイントと解決策を具体的に解説します。正しい情報に基づいた方法で原因を特定できるようになります。
目次
JSON parse 失敗 原因：構文エラーとフォーマットのミス
JSON解析で最も多い失敗原因は、構文やフォーマットの厳格なルール違反です。構造が少しでもルールに反すると、解析が失敗し「SyntaxError」などの例外が発生します。以下では具体的な構文ミスの種類と、それらがなぜエラーにつながるのかを詳しく掘り下げます。
トレーリングカンマの使用
オブジェクトや配列の最後に余分なカンマがあると解析が失敗します。例えば、{“name”: “Alice”,”age”: 30,}のように最後の要素の後ろにカンマがあると標準のJSON仕様に反します。このようなトレーリングカンマはJavaScriptのオブジェクトリテラルでは許可されていて慣れている人が多いため、無意識に書いてしまいがちです。解析エラー「Unexpected token ,」などが発生する典型的なパターンです。
ダブルクォーテーションで囲まれていないキーや値
JSONでは文字列とプロパティ名は必ずダブルクォーテーションで囲む必要があります。シングルクォーテーションやクオーテーションなしで書いたキーは構文エラーになります。また、文字列内の特殊文字（ダブルクォーテーション自身やバックスラッシュなど）は必ずエスケープする必要があります。これを怠ると解析処理で即座に失敗します。
コメントや余分なホワイトスペースの混入
JavaScriptのコード内ではコメントが許されていても、JSONにはコメントを含めることはできません。//や/* */によるコメントがあるだけで解析エラーになります。さらに、文字列内に改行や制御文字を適切に処理しないとエラーになることがあります。ホワイトスペースそのものは許されますが、文字列中の制御文字はエスケープが必要です。
JSON parse 失敗 原因：データ型や非標準の値の問題
JSON仕様では許されないデータ型や値が含まれている場合も解析が失敗します。明確にサポートされていない型を含めたり、非標準の値が渡されたりするとJSON.parseなどのメソッドは例外を投げます。その原因と予防法を以下に示します。
undefined、NaN、Infinityなどの非JSON値
JSON標準がサポートする値は、文字列、数値、真偽値、null、配列、オブジェクトの6種類のみです。undefined、NaN、Infinity、関数などは直接JSONに含めることができません。これらが含まれるとserialize段階またはparse段階でエラーが出ることがあります。サーバーサイドでのシリアライズ処理で代替値を使うなどの対策が有効です。
型の不一致および期待外の構造
クライアントや受信側のコードが特定のJSON構造（例えばオブジェクト内に特定のキー、ネストされた配列など）を期待しているのに、実際には異なる構造が返されるとエラーまたは機能不具合が発生します。API仕様が変わった場合や、フィールド名の誤りなどでこのミスマッチが起きやすいです。サンプルを確認して期待構造を検証することが重要です。
JSON parse 失敗 原因：エンコーディングと不可視文字の混入
見た目には正しいJSONでも、文字のエンコーディングや隠れた文字が原因で解析が失敗することがあります。特にUTF-8以外のエンコードや不可視文字の存在が解析を妨げます。以下では、見落としがちなエンコーディング関係の原因と具体的な確認方法を紹介します。
BOM（Byte Order Mark）の混入
ファイルの先頭にBOMと呼ばれる特殊なマークが付くことがあります。UTF-8だと0xEF 0xBB 0xBFという3バイトですが、このマークが文字列の先頭にあると解析器が最初の文字として認識できずエラーになることがあります。特にファイルを保存したエディタや環境によってBOM付きUTF-8になることがあるため、BOMなしに保存するかコード側で取り除く処理を入れると良いです。
不可視文字や制御文字の存在
ZWS（Zero Width Space）やノーブレークスペース、制御文字など、目に見えない文字が文字列に混入していると、見た目ではわからない構文エラーになります。特にエディタやコピー元から貼り付けたJSONにこれらが含まれていることがあります。対象文字を探して削除するか、正規表現で除去する処理を入れるとよいです。
JSON parse 失敗 原因：サーバー応答の内容やHTTPヘッダーの問題
解析エラーはクライアント側のコードだけでなく、サーバーが返す応答内容やHTTPヘッダーにも起因することがあります。JSONを期待していたのにHTMLや他形式が返る、あるいはヘッダーが正しく設定されていないなどの問題です。以下に代表的なケースと確認ポイントを解説します。
HTMLやエラーページが返されている
APIサーバーやバックエンドがエラーを起こした場合、HTML形式のエラーページが返されることがあります。そのとき、クライアントでJSON.parseを実行すると先頭が“<”文字になっており「Unexpected token <」などのエラーになります。ネットワークツールで応答本文を確認し、JSONではなくHTMLが返っていないかを見ることが重要です。
Content-Typeヘッダーの不一致
サーバーがJSONを返しているにも関わらず、HTTPレスポンスのContent-Typeヘッダーがapplication/jsonではない、または間違った型が設定されていると、クライアントが誤った形式と判断して解析に失敗することがあります。ヘッダーを正しく設定することと、クライアント側でヘッダーもチェックする習慣をつけることが有効です。
応答が空または部分的に欠落している
ネットワークのタイムアウトやサーバー側処理の中断などで、JSONデータが最後まで到達せず部分的にしか返ってこないことがあります。このような切れてしまったJSONに対してparseを行うと「Unexpected end of JSON input」などのエラーになります。ログ取得や応答内容の長さを確認することで、データが完全に来ているかを判断できます。
JSON parse 失敗 原因：クライアント側コードの問題と処理フロー
クライアント側でJSON.parseを呼び出すタイミングや条件に問題があると、意図しない失敗につながります。データソースの扱い、非同期処理、エラーハンドリングなどの流れが整っていないと原因がわかりにくくなります。以下に典型的なクライアント側の注意点を示します。
非同期処理の競合や処理タイミングの誤り
APIからの応答を受け取る前にJSON.parseを呼び出してしまうと、まだデータが読み込まれていない空文字列を解析しようとして失敗します。Promiseやfetch、XMLHttpRequestなどを使用する際には、レスポンスを完全に取得してからparse処理を行うようにし、awaitやthenの中での処理順を正しく保つことが重要です。
例外処理（try-catch）がない
JSON.parseは構文的に誤っていたり、予期しない入力が渡されたりすると例外を投げます。例外を捕まえる処理がなければアプリケーションはクラッシュしたりエラーメッセージが不適切な形で表示されます。try-catchを使って解析失敗時にフォールバックを提供することが望ましいです。
外部入力の検証不足
ユーザー入力や外部APIなどから受け取るJSONは、常に完全に正しいとは限りません。構造やデータ型が期待通りかを検証しないと、解析できない部分が紛れ込むことがあります。スキーマ検証ライブラリを使ったり、最初にJSONを文字列として検査することで安全性と解析成功率が高まります。
JSON parse 失敗 原因：ライブラリや環境固有の問題
使用しているランタイムやライブラリ、実行環境によってはJSON処理に影響を与える特有の問題があります。標準的なブラウザやNode.jsだけでなく、モバイルアプリやフレームワークでの動作にも注意が必要です。以下で主要な環境問題とその対応策を見ていきます。
古いパーサーや旧バージョンの仕様差異
JSON仕様は比較的安定していますが、古いバージョンのプラットフォームやサードパーティ製のパーサーにはいくつかの制約があります。例えば、BOMを扱えないもの、Unicodeの制御文字を許さないものなどです。最新の実装を使用するか、問題が報告されているパーサーを最新版に更新することが有効です。
大きなファイルや深いネストによるスタックオーバーフロー
非常に大きなデータ構造や深くネストされたオブジェクトは、メモリ使用量やコールスタック制限を超えてしまうことがあります。これによってparseが途中で失敗するか、処理不能になることがあります。可能であればデータを分割する、ストリーミングパーサーを使うなどして処理量を調整することが望ましいです。
言語やプラットフォーム特有の設定（例：Gsonのlenientなど）
Java、Swift、C#などの環境では、標準では厳格モードでJSONを処理するライブラリも多くあります。例えば、Gsonなどではlenient設定を有効にすると多少緩い構文を許すことがありますが、それでも仕様外の要素は基本的に排除されるべきです。設定を確認し、必要に応じて緩やかな処理や事前検証を加えると良いでしょう。
JSON parse 失敗 原因：最新の注意点と実践的な確認ポイント
ここまで構文・データ型・応答内容・クライアント側・環境依存と多角的に原因を見てきました。最後に実際に原因を特定するための具体的なチェックリストとツール、実践的な注意点を紹介します。これらを通じて「何が原因か」が迅速にわかるようになります。
レスポンス本文をログとネットワークタブで確認する
クライアント（ブラウザのデベロッパーツールやモニタリングツール）で、サーバーから返ってきたレスポンス本文をテキストとして確認してください。先頭が"<!DOCTYPE html>"や"<html>"になっていないか、空文字でないか、JSONの基本構造（{ } や [ ]）が始まっているかを見ます。これによりHTMLが返されているか、応答が欠落しているかがわかります。
HTTPヘッダーのContent-Typeをチェックする
Resonseヘッダーに含まれるContent-Typeフィールドがapplication/jsonであることを確認してください。もしtext/htmlやtext/plainなど別の型になっていると、クライアントが誤った型とみなして解析できないことがあります。サーバー側で正しいヘッダーを返す設定を行うか、クライアント側での型判断を明示的にすることが望ましいです。
JSONバリデーションツールで構造を検証する
オンラインバリデーターやIDEのプラグインを活用して、JSONを構文的にチェックします。波括弧・角括弧の対応、引用符の正しさ、特殊文字のエスケープなどを可視化できるものが良いです。これにより潜在的な見落としが早期に発見できます。
非同期処理・データ取得タイミングを整理する
fetchやAPI呼び出しなど非同期でデータを取得する際、レスポンスが完全に得られてからJSON.parseを呼ぶようにします。途中で処理を続けたり、promiseの解決前に文字列を解析したりすると失敗します。awaitやthenを適切に使い、長い応答のときはストリーミングやチャンク処理も検討すると良いです。
まとめ
JSON parse 失敗 原因には、構文上のルール違反、非標準なデータ型、エンコーディングや不可視文字の混入、サーバーの応答内容やHTTPヘッダーの問題、クライアント側コードや環境固有の制約など多くの要因があります。これらはいずれも少しのミスで起こりうるものであり、見落としがちです。
原因を突き止めるには、レスポンスを実際に確認する、ヘッダーと構造を検証する、構文をオンラインツールでチェックする、非同期処理を整理するなどの実践的な確認が有効です。これらの注意点を習慣化することで、parseの失敗を減らし信頼性の高いデータ処理が可能になります。
コメント