JSON 복구 도구 출시: 브라우저에서 잘못된 JSON 자동 수정하기
JSON Work 제품군에 JSON 복구 도구(JSON Repair Tool) 가 새로 추가되었습니다.
로그, 브라우저 개발자 도구, 서드파티 콘솔 등에서 JSON 을 복사하다 보면, 실제로는 거의 JSON 이지만 완전히 유효하지는 않은 텍스트를 자주 보게 됩니다. 예를 들어:
- • 속성 사이에 쉼표(,)가 빠져 있거나
- •
// ...,/* ... */같은 JavaScript 스타일 주석이 섞여 있고
- • 쌍따옴표 대신 작은따옴표를 사용하거나
- •
True/False/NULL처럼 대소문자가 제각각이거나
- • 위와 같은 문제가 한 번에 여러 개 섞여 있는 경우까지
기존 JSON 검증기나 포매터는 보통 어디가 잘못됐는지 알려주는 것까지만 해 주고, 실제로 수정까지 대신해 주지는 않습니다. JSON 복구 도구는 바로 이런 “애매하게 깨져 있는 JSON”을 최대한 안전하게 고치는 데 초점을 맞췄습니다.
🔧 JSON 복구 도구가 해 주는 일
이 도구는 유효하지 않은 JSON 문자열을 입력으로 받아, 여러 단계를 거쳐 유효한 JSON으로 만드는 것을 시도합니다. 그 과정에서:
- • 작업은 100% 브라우저 로컬에서만 실행되고
- • 동일한 입력에 대해서는 항상 같은 결과를 내도록 설계되어 있으며
- • 어떤 수정이 이루어졌는지는 “수정 요약(Repair summary)” 에 단계별로 기록됩니다.
현재 자동으로 고칠 수 있는 대표적인 문제들
- • 객체 속성 사이의 누락된 쉼표
- 수정 전:
{
"name": "John",
"age": 30
"city": "New York"
}- 수정 후:
{
"name": "John",
"age": 30,
"city": "New York"
}- • JavaScript 스타일 주석
- // 라인 주석, /* 블록 주석 */ 를 제거
- • 작은따옴표 문자열
- 가능한 경우 'value' 를 "value" 로 변환
- • 따옴표가 없는 키
- 예: { name: "John" } → { "name": "John" }
- • 불리언 / null 대소문자 문제
- True / False / NULL / Null 등을 소문자 리터럴로 정규화
입력 JSON 이 이미 유효하다면, 단순히 포맷을 예쁘게 정리하고 “원래부터 유효함” 이라는 상태를 표시합니다.
🧠 복구 알고리즘은 어떻게 동작하나요?
내부적으로 JSON 복구 도구는 여러 개의 작고 안전한 변환 단계를 차례대로 수행하면서, 각 단계 뒤마다 JSON.parse 를 시도합니다.
대략적인 순서는 다음과 같습니다.
- 여분의 공백 / BOM 제거 및 줄바꿈 통일
- 주석 제거
- 속성 사이의 누락된 쉼표 삽입
, }/, ]같은 잘못된 꼬리 쉼표 제거
- 불리언 / null 리터럴 대소문자 정규화
- 작은따옴표 문자열을 쌍따옴표로 변환
- 따옴표가 없는 키에 따옴표 추가
각 단계를 거친 뒤마다 JSON.parse 를 호출해 보고, 어느 시점에든 정상적으로 파싱되면 그 시점에서 더 이상 문자열을 건드리지 않고 결과를 표준 JSON 포맷으로 출력합니다.
모든 단계를 거쳤음에도 여전히 파싱할 수 없다면,
- • 이미 적용된 모든 정리/수정 결과를 포함한 부분적으로 정리된 텍스트를 보여주고
- • 마지막 파싱 시도의 에러 메시지를 그대로 제공하며
- • 어떤 수정이 자동으로 적용되었는지 단계별 요약 목록을 함께 제공합니다.
🖥 언제 JSON 복구 도구를 쓰면 좋을까요?
도구 주소는 다음과 같습니다.
- •
/tools/formatters/json-repair(각 언어별로 앞에 locale prefix 가 붙습니다)
몇 가지 대표적인 워크플로우를 예로 들면:
1. API 응답 디버깅
- • 브라우저 개발자 도구에서 JSON 비슷한 응답을 복사해 온 뒤
- • 그대로 JSON 복구 도구에 붙여 넣고
- • 정상적인 JSON 으로 고친 결과를 받아서:
- 검증기(Validator)에 넣어 구조를 점검하거나
- 포매터(Beautifier)로 보기 좋게 정리하거나
- 동료에게 공유하여 이슈를 함께 분석할 수 있습니다.
2. 로그 데이터 정리
- • 로그 파일에는 종종 주석이나 잘못된 문자열이 섞인 JSON 조각이 등장합니다.
- • 이 조각들을 복구 도구에 넣으면,
- 주석을 제거하고
- 자잘한 구문 오류를 수정하며
- 사람이 읽기 편한 형태의 JSON 으로 정리해 줍니다.
3. 서드파티 도구와의 연동
- • 일부 외부 시스템은 “JSON 비슷한 설정 파일”을 내보내지만, 실제로는 표준 JSON 이 아닌 경우가 많습니다.
- • 먼저 복구 도구로 엄밀한 JSON 으로 변환한 다음:
- JSON Schema 로 검증하거나
- CSV / XML / YAML 등 다른 포맷으로 변환하거나
- 린터 / 정적 분석 도구에 넘길 수 있습니다.
🔒 프라이버시와 로컬 처리
JSON Work 의 다른 도구들과 마찬가지로, JSON 복구 도구도 프라이버시 우선 원칙을 따릅니다.
- • 모든 처리는 브라우저 내부에서만 실행됩니다.
- • 입력한 내용이 네트워크를 통해 전송되지 않습니다.
- • 서버 쪽에는 여러분이 붙여 넣은 데이터가 로그로 남지 않습니다.
민감한 프로덕션 데이터, 사용자 정보, 비밀 값이 섞여 있는 로그를 다룰 때도 안심하고 사용할 수 있습니다.
🌍 JSON Work 내 다른 도구와의 연동
JSON 복구 도구는 JSON Work 안의 다른 주요 도구와 자연스럽게 연결됩니다.
- • JSON 검증기로 구조와 스키마를 점검하고
- • JSON 포맷터(Beautifier) 로 최종 포맷을 다듬고
- • JSON 트리 뷰어로 구조를 시각적으로 확인하고
- • JSON Diff 도구로 복구 전/후의 차이를 비교할 수 있습니다.
또한 포매터/검증기 페이지의 “관련 도구” 섹션에서도 JSON 복구 도구 링크를 쉽게 찾을 수 있습니다.
✅ 지금 바로 사용해 보세요
- JSON 복구 도구에 접속합니다.
- 잘못되었거나 유효하지 않은 JSON 을 그대로 붙여 넣습니다.
- 도구가 자동으로 복구를 시도하도록 둡니다.
- 결과를 복사하거나 파일로 다운로드합니다.
- 필요하다면 검증기/포맷터/트리 뷰어와 연계하여 후속 작업을 진행합니다.
실제 사용 중에 더 다뤄주었으면 하는 에지 케이스나 규칙이 있다면, 언제든지 피드백을 주시면 JSON Work 의 향후 개선에 적극 반영하겠습니다.