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 코드 블록

세 개의 백틱(```)으로 감싸진 코드 스니펫. 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용 레퍼런스 구현