JSON構文エラー 原因と位置の見つけ方

JSONを貼り付けたときに表示される「Unexpected token」エラーは、JSONの文法ルールのどれかに違反しているという意味です。エラーメッセージの中には、どの文字で、何番目の位置で問題が起きたのかがすでに示されています。この記事では、よく出る文法エラーの種類と、そのメッセージを読んで原因を特定する方法をまとめます。
まとめ ① JSONは、末尾のカンマ・シングルクォート・コメント・クォートなしのキーを文法的に許可していません。 ② JSON.parseが投げるエラーメッセージには、問題になった文字と位置(position)が一緒に表示されます。 ③ 位置の値は文字列の先頭から数えた文字数なので、その地点の前後を見れば原因を絞り込めます。
なぜこのエラーがよく起きるのか
APIレスポンスをコンソールからコピーして設定ファイルに貼り付けたり、複数のレスポンスを手でつなぎ合わせているうちに、最後の項目の後ろにカンマをひとつ余計に残してしまうことがよくあります。JavaScriptのコードの中にあったオブジェクトリテラルをそのまま切り出して、JSONとして貼り付けてしまうケースもよくあります。
この2つの文法は見た目が似ていますが、ルールは異なります。JavaScriptのオブジェクトリテラルでは通る表現(シングルクォート、クォートなしのキー、末尾のカンマ)が、JSONではすべて文法エラーになります。そのため、コードでは問題なく動いていた値をそのまま移すと、JSON.parseはすぐにエラーを投げます。
厄介なのは、エラーメッセージが「Unexpected token } in JSON at position 42」のようにコードのように見える点です。どの文法ルールに違反したのか、42という数字が何を指しているのかがわからないと、メッセージを読んでも原因にたどり着けません。
JSONの文法ルールとエラーメッセージの読み方
JSONは決められた文法に従う標準フォーマットです。実際にエラーを引き起こすルールは、いくつかに整理できます。
- 文字列とキーは必ずダブルクォート(")で囲みます。シングルクォート(')はJSONの文法にありません。
- オブジェクトや配列の最後の項目の後ろにはカンマを付けません(末尾のカンマは禁止)。
- キーは常にクォートで囲んだ文字列でなければなりません。クォートなしのキーはJSONではなく、JavaScriptのオブジェクトリテラルの文法です。
- コメント(// または /* */)はJSONの文法自体に含まれていません。
- 数値は、先頭に不要な0を付けたり(01のように)、+記号を付けたり、NaN・Infinityのような値を使ったりできません。
- true、false、nullは小文字でのみ書きます。
このルールのどれかひとつでも破ると、ブラウザのJSON.parseは値を返さずにエラー(SyntaxError)を投げます。
エラーメッセージの位置(position)情報の読み方
このエラーには2つの情報が含まれます。問題になった文字と、その文字が文字列の何番目にあるかを示す位置(position)です。位置は改行も含めて、文字列の先頭(0)から数えた文字数です。
メッセージの形式はブラウザエンジンによって異なります。Chromium系はposition(文字位置)、Firefox系はline・column(行・桁)の形で表示しますが、指している地点は同じです。
原因を探すには、この位置を基準に前後の文字を見ればOKです。ただしJSONが長くなるほど、位置を手で数えるのは面倒で、ずれも生じやすくなります。
無料ツール「JSONフォーマッター・バリデーター」で確認する。
JSONを貼り付けて整形ボタンを押すと、エラーの位置とメッセージをすぐに確認できます。処理はブラウザ内だけで行われ、サーバーには送信されません。

よく混同される文法エラーの種類
同じ「エラーが出る」という結果でも、原因はそれぞれ異なります。よく出る種類を整理すると次のとおりです。
| エラーの種類 | 例 | なぜエラーなのか |
|---|---|---|
| 末尾のカンマ | {"a":1,"b":2,} | 最後の項目の後ろにはカンマを付けません |
| シングルクォートの使用 | {'a':1} | 文字列・キーはダブルクォートのみ許可されます |
| キーのクォート漏れ | {a:1} | キーは必ずクォートで囲んだ文字列でなければなりません |
| コメントの混入 | {"a":1} // 説明 | JSONの文法にコメントはありません |
| undefined値 | {"a":undefined} | JSONはundefinedを表現できません(nullのみ可能) |
| 数値の先頭0 | {"a":01} | 0で始まる数値は0そのもの以外は許可されません |
このうち末尾のカンマとシングルクォートは、JavaScriptのコードでは自然に使われる表現なので、コードから値をコピーしてJSONに移すときに特に紛れ込みやすくなります。
まとめ
- JSONはダブルクォートやカンマのルールなど、決められた文法に従うフォーマットであり、JavaScriptのオブジェクトリテラルとは文法が異なります。
- 末尾のカンマ、シングルクォート、クォートなしのキー、コメントの混入が、実際に最もよく出るエラーの原因です。
- JSON.parseが投げるエラーメッセージには、問題になった文字と位置(positionまたはline/column)が一緒に含まれます。
- 位置の値は文字列の先頭から数えた文字数なので、その地点の前後を確認すれば原因を絞り込めます。
- 長いJSONでは、位置を手で数える代わりにツールで直接確認するほうが速くて正確です。
JSONを貼り付けて整形ボタンを押すと、エラーの位置とメッセージをすぐに確認できます。処理はブラウザ内だけで行われ、サーバーには送信されません。
よくある質問
「Unexpected token」エラーは正確にはどういう意味ですか?
JSON.parseが、文法的にあり得ない文字に出会ったという意味です。メッセージにはその文字と、文字列の何番目(position)で見つかったかが一緒に表示されます。位置の前後を確認すれば、原因はすぐに見つかります。
positionの後ろに付いている数字は何を意味しますか?
文字列の先頭を0として数えた文字数(文字インデックス)です。改行文字も含めて数えます。たとえばposition 42なら、文字列の先頭から43番目の文字の位置で問題が起きたという意味です。
コメントがあるJSONはなぜエラーになるのですか?
JSONの文法自体にコメントの記法が定義されていないからです。// や /* */ のようなコメントはJavaScriptやJSON5・JSONCといった拡張形式では許可されますが、標準のJSONではエラーとして扱われます。
JavaScriptのオブジェクトをそのままJSONとして書いてもいいですか?
いいえ、できません。JavaScriptのオブジェクトリテラルは、キーのクォートを省略したりシングルクォートを使ったり、末尾のカンマを残したりできますが、JSONはこうした表現をすべて文法エラーとみなします。ダブルクォートで囲み、最後のカンマを消してはじめてJSONとして使えます。
この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む