API 통신이나 설정 파일 작성 중 발생하는 작은 오타 하나가 전체 시스템을 멈추게 만든다. 특히 JSON 데이터는 쉼표 하나나 따옴표 누락에도 민감하게 반응한다. 배포 직전 혹은 데이터 전송 전에 내 코드가 올바른 규격을 따르고 있는지 점검하는 과정이 필요한 이유이다.
JSON 문법 자가진단 체크리스트
JSON 문법 검증 항목
- 모든 키(Key) 이름이 큰따옴표로 감싸져 있다.필수
- 문자열 값에 작은따옴표 대신 큰따옴표를 사용했다.필수
- 객체나 배열의 마지막 항목 뒤에 불필요한 쉼표(Trailing comma)가 없다.주의
- 중괄호 {} 와 대괄호 [] 의 짝이 정확하게 맞는다.필수
- 주석 문법(// 또는 /* */)을 JSON 파일 내부에 포함하지 않았다.주의
아래 항목을 읽고 현재 다루고 있는 데이터에 해당하는지 확인한다. 이 점검은 개발 환경이나 브라우저 콘솔에서 마주치는 에러를 사전에 방지하기 위한 목적이다.
- 모든 키(Key) 이름이 큰따옴표로 감싸져 있다.
- 문자열 값에 작은따옴표 대신 큰따옴표를 사용했다.
- 객체나 배열의 마지막 항목 뒤에 불필요한 쉼표(Trailing comma)가 없다.
- 데이터 타입에 맞지 않는 따옴표를 숫자나 불리언(Boolean) 값에 붙이지 않았다.
- 중괄호
{}와 대괄호[]의 짝이 정확하게 맞는다. - 주석 문법(
//또는/* */)을 JSON 파일 내부에 포함하지 않았다. - 특수문자나 줄바꿈이 포함된 경우 이스케이프 처리가 올바르게 되었다.
진단 결과 해석
체크리스트 중 하나라도 해당하지 않거나 확신이 서지 않는 항목이 있다면, 파싱 에러나 데이터 전송 실패로 이어질 가능성이 높다. 특히 자바스크립트 객체 리터럴과 표준 JSON 규격을 혼동하여 작은따옴표를 쓰거나 마지막 쉼표를 남겨두는 실수가 가장 빈번하다.
이런 휴먼 에러는 육안으로 수천 줄의 코드를 검사하며 찾아내기 어렵다. 표준 규격인 RFC 8259에 부합하는지 기계적으로 검증하고 시각적으로 구조를 파악하는 JSON 포맷터 & 뷰어 같은 도구가 필요하다.
다음 단계: 실시간 검증과 정렬 활용하기
실시간 검증 및 정렬 절차
- 1데이터 입력
작성 중이거나 수신한 데이터를 입력창에 붙여넣기
- 2에러 파악
실시간 린팅 기능을 통해 에러가 발생하는 정확한 라인 번호와 원인 확인
- 3구조 수정
들여쓰기 옵션을 조정해 계층 구조를 확인하고 올바르지 않은 문법 수정
- 4데이터 반영
정렬된 데이터를 복사하여 배포 환경이나 API 페이로드에 반영
문제가 의심되는 데이터를 발견했다면 에디터에 직접 붙여넣어 구조를 점검한다.
- 작성 중이거나 수신한 데이터를 JSON 포맷터 & 뷰어 입력창에 붙여넣는다.
- 실시간 린팅 기능을 통해 에러가 발생하는 정확한 라인 번호와 원인을 파악한다.
- 들여쓰기 옵션을 조정해 계층 구조를 시각적으로 확인하고 올바르지 않은 문법을 수정한다.
- 정렬된 데이터를 복사하여 배포 환경이나 API 페이로드에 반영한다.