JSON 오류를 고치고 읽기 좋게 정리하려면?

API 응답이나 설정 JSON이 처리되지 않을 때, 문법 오류인지 단순히 읽기 어려운 것인지부터 구분하세요. 아래 예제로 오류를 고친 뒤 맞는 도구로 이어갈 수 있습니다.

작성·관리: Utilook

어느 도구부터 사용할까요?

포맷은 파싱할 수 있는 입력을 다시 출력해 들여쓰기를 붙입니다. 문법 검사는 입력이 JSON 문법을 따르는지 확인합니다. 스키마 검사는 그다음에 필수 필드, 값의 자료형, API 계약처럼 데이터 자체의 규칙을 확인합니다.

예를 들어 {"age":"unknown"}은 문법상 JSON이지만 age에 숫자가 필요하다면 애플리케이션에서는 거부할 수 있습니다. 포맷 성공이나 문법 검사 성공만으로 데이터 규칙까지 통과했다고 판단하지 마세요.

어느 도구부터 사용할까요?
이런 상황이라면선택과 다음 행동
쉼표·따옴표 오류가 의심됨유효성 검사에서 오류를 찾고 고친 뒤 다시 검사하세요.JSON 유효성 검사
문법은 맞지만 한 줄이라 읽기 어려움포맷터로 들여쓰기를 적용하세요. 입력은 Utilook 서버로 전송됩니다.JSON 포맷터
문법은 맞는데 앱이 데이터를 거부함필수 필드·자료형·업무 규칙을 별도의 Schema 또는 앱 검사로 확인하세요. 두 도구는 이를 검사하지 않습니다.

오류를 읽는 데 필요한 문법만 살펴보기

객체는 중괄호 안의 이름과 값으로, 배열은 대괄호 안의 값들로 구성됩니다. 속성명과 문자열에는 큰따옴표를 쓰고, 이름과 값은 콜론으로, 항목은 쉼표로 구분합니다. 숫자, true, false, null도 값이 될 수 있습니다.

JSON에는 주석이나 마지막 항목 뒤의 쉼표가 없으며 작은따옴표는 문자열 구분자로 사용할 수 없습니다. JavaScript 객체 리터럴을 그대로 붙여넣으면 이 차이 때문에 실패하기 쉽습니다.

마지막 쉼표

잘못된 예

{"name":"Utilook",}

수정한 예

{"name":"Utilook"}

작은따옴표

잘못된 예

{'name':'Utilook'}

수정한 예

{"name":"Utilook"}

오류를 고치는 순서

파서가 가리킨 위치가 항상 실수한 문자 자체는 아닙니다. 빠진 쉼표나 괄호 때문에 그다음 토큰에서 오류를 발견할 수도 있습니다.

  1. JSON 유효성 검사에서 먼저 문법을 확인합니다.
  2. 행·열이 표시되면 해당 문자와 바로 앞의 따옴표·쉼표·괄호를 함께 봅니다. 위치가 없으면 파서 설명을 기준으로 앞뒤 구조를 점검합니다.
  3. 문법을 고친 뒤 다시 검사하고, 통과하면 JSON 포맷터로 중첩 구조를 정리합니다.
  4. 필수 필드나 자료형이 중요한 데이터라면 별도의 JSON Schema 또는 애플리케이션 검사를 수행합니다.

Utilook의 두 도구는 파서와 처리 위치가 다릅니다

JSON 유효성 검사는 브라우저의 JSON.parse를 사용합니다. 입력 JSON은 서버로 보내지 않으며, 성공한 검사 뒤에는 입력 내용이 없는 도구 실행 통계 요청만 전송합니다.

JSON 포맷터는 입력을 Utilook 서버로 보내 파싱하고 공백 2칸 또는 4칸으로 다시 출력합니다. 이 기능은 입력과 결과를 DB에 저장하지 않지만 민감한 데이터를 서버로 보내기 전에는 확인해야 합니다. 객체 키 정렬을 켜면 키 순서가 바뀌고, 다시 직렬화하면서 원본 표기가 달라질 수 있습니다.

NaN·Infinity·-Infinity는 RFC 8259의 표준 JSON 값에는 포함되지 않습니다. 포맷터도 이 값을 거부하며, 1e400처럼 서버의 유한 실수 범위를 벗어나는 숫자는 별도 범위 오류로 처리합니다. 문법 오류 위치를 찾을 때는 브라우저 검사기를 먼저 사용하고, 포맷 성공을 JSON Schema나 업무 규칙 검증과 혼동하지 마세요.

직접 재현한 결과와 실패 조건

중첩 데이터와 문법 오류를 구분

목적
정리할 수 있는 입력인지 먼저 판단합니다.
입력
{"items":[{"ok":true},null,2]}
{"name":"Utilook",}
실행 조건
로컬 서버 API와 Chrome 157의 실제 Validator. Formatter는 들여쓰기 2칸·키 정렬 끔. 도구 구현 기준 b39fba9.
확인한 결과
첫 입력: Validator 통과, Formatter HTTP 200
{
  "items": [
    {
      "ok": true
    },
    null,
    2
  ]
}
마지막 쉼표 입력: Validator 오류, Formatter HTTP 422 / invalid_json
해석
포맷터는 문법을 자동 수리하지 않습니다. 오류 뒤 성공 결과와 복사 가능 상태가 남지 않는지 함께 확인합니다.
한계·실패 조건
문법 통과는 필수 필드·업무 규칙을 검증하지 않습니다. 오류 위치 표현은 브라우저마다 다를 수 있습니다.
다음 행동
쉼표를 수정하고 다시 검사한 뒤 필요한 경우 별도 Schema·앱 검사를 수행하세요.

NaN·Infinity와 큰 지수는 다른 오류

입력
{"value":NaN}
{"value":Infinity}
{"n":1e400}
실행 조건
같은 입력을 실제 브라우저 Validator와 서버 Formatter API에 적용.
확인한 결과
NaN / Infinity: 둘 다 거부
1e400: Validator 문법 통과, Formatter number_out_of_range
해석
NaN·Infinity는 표준 JSON 값이 아닙니다. 반면 1e400은 숫자 문법에는 맞아도 서버의 유한 부동소수점 범위를 넘습니다. Chrome의 JSON.parse 결과도 Infinity가 되지만 Validator 화면은 문법 통과 여부만 표시합니다.
한계·실패 조건
숫자 범위와 문법, 안전한 정밀도는 별개입니다. 브라우저의 문법 통과를 계산에 쓸 수 있는 유한 숫자 보장으로 보지 마세요.
다음 행동
수신 시스템의 숫자 범위를 확인하고, 식별자·매우 큰 수는 계약에 맞는 문자열 표현도 검토하세요.

큰 정수와 중복 키에서 잃는 정보

입력
{"n":9007199254740993}
{"x":1,"x":2}
실행 조건
Chrome 157 JSON.parse와 Python 서버 파서의 실제 실행 대조.
확인한 결과
큰 정수: Formatter는 9007199254740993 유지
브라우저 내부 파싱 값: 9007199254740992
중복 키: 둘 다 문법 통과, 마지막 값 x=2만 유지
해석
Validator는 원문을 재출력하지 않으므로 정수의 원문을 화면에서 바꾸지는 않습니다. 그러나 그 파싱 방식을 후속 JavaScript 계산에 사용하면 정밀도를 잃을 수 있습니다. 중복 키는 정리 과정에서 앞선 값이 사라집니다.
한계·실패 조건
Formatter도 원래 숫자 표기·중복 필드를 보존하는 원문 편집기는 아닙니다. 중복 키의 수신 동작은 시스템마다 다릅니다.
다음 행동
원문을 보관하고 중복 키를 없애세요. 큰 정수는 대상 시스템에서 손실 없이 다룰 방식인지 확인하세요.

이어서 도구 사용하기

참고 자료

사례 확인 범위와 변경 이력

작성·관리: Utilook · 재현 사례 확인일:

Utilook이 관리하는 도구 구현과 이 글의 추가 사례를 코드·자동 브라우저·지정된 환경에서 대조했습니다. 네트워크 실측과 fixture는 각 조건에서 구분하며, 이 날짜는 전체 사이트·법률·운영 로그를 확인했다는 뜻이 아닙니다.

  • 이번 변경: 입력·조건·실제 결과·해석·한계·다음 행동을 추가하고 기존 설명·샘플을 보존했습니다.
오류·설명 수정 요청