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 를 시도합니다.

대략적인 순서는 다음과 같습니다.

1. 여분의 공백 / BOM 제거 및 줄바꿈 통일

1. 주석 제거

1. 속성 사이의 누락된 쉼표 삽입

1. , } / , ] 같은 잘못된 꼬리 쉼표 제거

1. 불리언 / null 리터럴 대소문자 정규화

1. 작은따옴표 문자열을 쌍따옴표로 변환

1. 따옴표가 없는 키에 따옴표 추가

각 단계를 거친 뒤마다 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 복구 도구 링크를 쉽게 찾을 수 있습니다.

---

✅ 지금 바로 사용해 보세요

1. JSON 복구 도구에 접속합니다.

1. 잘못되었거나 유효하지 않은 JSON 을 그대로 붙여 넣습니다.

1. 도구가 자동으로 복구를 시도하도록 둡니다.

1. 결과를 복사하거나 파일로 다운로드합니다.

1. 필요하다면 검증기/포맷터/트리 뷰어와 연계하여 후속 작업을 진행합니다.

실제 사용 중에 더 다뤄주었으면 하는 에지 케이스나 규칙이 있다면, 언제든지 피드백을 주시면 JSON Work 의 향후 개선에 적극 반영하겠습니다.