JSON 修復

関連おすすめ

JSON修復（JSON Repair）とは？

ユースケース

• AI/LLM出力クリーンアップ：ChatGPT/Claudeが返すMarkdownラッパー、説明文、末尾カンマ付きJSONをワンクリックで標準JSONに変換
• APIデバッグとトラブルシューティング：ゲートウェイやネットワーク問題でAPIレスポンスが切り捨てられた場合、括弧と文字列を素早く補完して元のデータ構造を特定
• JavaScriptからコピーしたオブジェクトリテラル：シングルクォート、末尾カンマ、引用符なしキー名をワンストップで修正
• 設定ファイルクリーンアップ：JSON5/JSONCのコメントを除去して標準JSONを取得し、下流サービスへの統一的な接続を容易に
• ログとクリップボードデータ修復：コメント、特殊空白、切り捨てを含むJSON断片を素早く標準化
• データ移行とスクリプト前処理：データ移行パイプラインに修復ステップを追加し、少数の不正JSONがETLバッチ全体をブロックするのを防止

使い方

1. エラー、Markdownラッパー付き、または破損したJSON内容を左側の入力ボックスに貼り付けるか、「サンプル」をクリックして典型的な破損JSONを読み込むか、.json/.txtファイルをアップロードします
2. ツールが自動的に一般的な構文問題を検出・修正し、右側の出力エリアにフォーマット済みの標準JSONと各種類の問題の修復数を表示します
3. 赤いエラーメッセージが残っている場合は、入力エリアで手動編集してから修復を再トリガーできます（Mac: ⌘+Shift+R、Windows: Ctrl+Shift+R）
4. 構造が正しいことを確認したら、「コピー」をクリックして修復結果をクリップボードに入れるか、「ダウンロード」をクリックしてrepaired.jsonとして保存し、フォーマットや検証などの後続処理に進みます

特徴

• 7種類の一般的な構文エラーに対応：末尾カンマ、シングルクォート、引用符なしキー、未閉じ文字列、コメント、括弧不足、Markdownコードブロックラッパー
• AI出力クリーンアップ最適化：```json ラッパーとコードブロック外の説明文を自動除去、ChatGPT、Claude、GeminiなどLLMの典型的な出力を認識
• JSON5/JSONC互換：コメント、緩い引用符、特殊空白（不可視Unicode文字など）を含む拡張構文も解析可能
• 破損JSONスマート補完：APIレスポンスの切り捨てやコピー内容の末尾括弧欠落に対応し、欠落した括弧と引用符を自動補完
• 修復問題の可視化：各種類の問題が修復された回数を自動集計・表示し、監査と人手確認を容易に
• ローカル処理でプライバシー保護：解析、修復、フォーマットはすべてブラウザ内で完結、入力内容は一切サーバーに送信されない
• フォーマットとのシームレス連携：修復後の標準JSONはワンクリックでJSONフォーマット、Schema検証、コード生成などの後続処理に進める
• ファイルとサンプルの読み込み：.json/.txtファイルのアップロードまたはサンプル読み込みクリックに対応し、修復効果を素早く検証可能

コード例

// npm install jsonrepair
import { jsonrepair } from 'jsonrepair';

const broken = `{
  name: 'Alice',
  age: 30,
  tags: ['dev', 'writer',], // trailing comma + comment
}`;

try {
  const fixed = jsonrepair(broken);
  const obj = JSON.parse(fixed);
  console.log(obj);
  // => { name: 'Alice', age: 30, tags: ['dev', 'writer'] }
} catch (err) {
  console.error('Still unrepairable:', err.message);
}

# pip install jsonrepair
from jsonrepair import jsonrepair
import json

broken = '''{
  name: "Alice",
  age: 30,
  tags: ["dev", "writer",], // trailing comma + comment
}'''

fixed = jsonrepair(broken)
obj = json.loads(fixed)
print(obj)
# => {'name': 'Alice', 'age': 30, 'tags': ['dev', 'writer']}

# オブジェクト/配列の末尾カンマを除去（応急処置。コメント/シングルクォートは非対応）
# 複雑なシナリオでは jsonrepair などの専用ライブラリを使用してください
sed -E 's/,([ \t]*[}\]])/\1/g' broken.json > clean.json

# 修復結果を検証
jq . clean.json >/dev/null && echo 'JSON is valid'

よくある質問

トラブルシューティング

用語集

JSON

JavaScript Object Notation。RFC 8259で定義されたキーバリューベースの軽量データ交換フォーマット。REST API、設定ファイル、ログのデファクトスタンダード。

RFC 8259

IETFが発行したJSON公式仕様。合法的なJSONの厳密な構文を定義——すべてのキーはダブルクォートで囲み、文字列内でエスケープが必要な文字は限定的で、コメントと末尾カンマは許可されない。

JSON.parse

JavaScript / モダンブラウザに組み込まれた厳密なJSONパーサー。RFC 8259に準拠し、構文エラーが発生すると直接SyntaxErrorをスローし、許容修復はできない。

JSON5

JSONの拡張構文（非標準）。引用符なしキー、シングルクォート文字列、コメント（// と /* */）、末尾カンマ、16進数などを許可。人間の手書きには適するがJSON.parseとは互換性がない。

JSONC

JSON with Comments。VS Codeなどのエディタがコメント付きJSON設定ファイル（tsconfig.jsonなど）を指す総称。実質的にJSON5の一般的な別名。

Trailing Comma / 末尾カンマ

オブジェクトや配列の最後の要素の後にある余分なカンマ。JavaScriptでは許可されるがJSON標準では禁止。LLM出力やconsole.log()コピーで最も一般的な構文エラー。

Markdown コードブロック

3つのバッククォート（```）で囲まれたコードスニペット。LLMはJSONを出力する際に自動で```json ... ```でラップすることが多く、そのままJSON.parse()に貼り付けると失敗する。

Tolerant Parser / 許容解析

構文エラー発生時に回復を試みて解析を続行できるパーサー。JSON修復ツールの中核エンジンであり、厳密なJSON.parseとは区別される。

SyntaxError

JavaScriptがスローする構文エラー例外。厳密なJSONパーサーはRFC 8259に準拠しない入力を受け取ると常にこのエラーをスローする。

Canonical JSON / 正規化JSON

parse + stringifyで再生成されたJSON。キー順序が安定し、余分な空白がなく、標準パーサーと100%互換。JSON修復ツールの最終出力形式。

JSON修復の一般的なエラータイプと例

JSON修復 vs JSONフォーマット vs JSON Schema検証

Authoritative References

• IETFJSON 公式仕様 (RFC 8259)
• MDNJSON.parse - MDN Web ドキュメント
• JSON5JSON5 - 非公式拡張構文仕様
• GitHubjsonrepair (josdejong) - ブラウザ & Node 向けリファレンス実装