JSON パースエラー: よくある 10 の失敗と修正方法

1. キーや文字列をシングルクォートで書く

JSON ではキー名と文字列値にダブルクォートが必須です。JavaScript のオブジェクトリテラルはシングルクォートを許可しますが、JSON では不可です。

代表的なエラー: Unexpected token ' in JSON at position …

無効

{
  name: "Alice",
  "age": 30
}

修正後

{
  "name": "Alice",
  "age": 30
}

最後のプロパティや配列要素の後ろにカンマは置けません。エディタが自動で末尾カンマを入れると、厳密な JSON パーサーで失敗します。

JavaScript リテラル（ES2019+）では末尾カンマを許可しますが、JSON 仕様（RFC 8259）では常に禁止です。

無効

{
  "items": [1, 2, 3,],
  "tags": ["a", "b",]
}

修正後

{
  "items": [1, 2, 3],
  "tags": ["a", "b"]
}

すべてのキーはダブルクォート付き文字列である必要があります。{ active: true } は JSON では無効です。

{
  active: true,
  "score": 95
}

隣接するキーと値のペアにはカンマが必要です。重複カンマは Unexpected token エラーの原因になります。

カンマ不足

{
  "a": 1
  "b": 2
}

余分なカンマ

{
  "a": 1,, "b": 2
}

パス内のバックスラッシュは 2 重にする必要があります（\ は \\）。単独のバックスラッシュは Bad escaped character を引き起こします。

無効

{ "path": "C:\Users\data" }

修正後

{ "path": "C:\\Users\\data" }

JSON で空値として使えるのは null のみで、NaN や undefined など JavaScript 固有値は使えません。

{ "value": NaN }

JSON には // や /* */ コメントはありません。パース前に必ず削除してください。

ドキュメント例、VS Code の JSONC、JSON5 はコメントを許可しますが、JSON.parse には入力できません。データ交換では厳密な JSON を使いましょう。

{
  // user profile
  "name": "Bob"
}

有効な JSON のルートは 1 つのオブジェクトまたは 1 つの配列です。} や ] の閉じ忘れは Unexpected end of JSON input につながります。

先頭ゼロ（007）、16 進（0xFF）、小数点単体は使えません。

文字列内の改行やタブは実文字ではなく \n、\t で表現します。ログ由来の生改行をそのまま入れると失敗します。

JSON ツールにテキストを貼り付けると、失敗時にサイドバーへエラーメッセージと行番号が表示され、エディタがその行をハイライトします。

修正後に再度フォーマットまたはミニファイして、成功バナーが出れば JSON は有効です。