가이드
JSON 파싱 오류 예시와 읽는 방법
자주 발생하는 JSON 오류 메시지를 읽고 빠르게 수정하는 방법을 설명합니다.
JSON 오류 메시지는 처음 보면 어렵게 느껴지지만 대부분은 작은 문법 실수입니다. 메시지 구조를 읽는 법만 익히면 수정 속도가 크게 빨라집니다.
파싱 오류 메시지의 기본 구조
대부분 오류는 무엇이 잘못됐는지, 어디서 발생했는지, 무엇을 기대했는지를 알려줍니다.
도구마다 표현은 달라도 line/column 정보는 원인 근처를 가리킵니다.
예시 1: 필드 사이 쉼표 누락
객체 항목 사이에 쉼표를 빼먹으면 자주 발생합니다.
메시지에 ', 또는 } 예상'처럼 나오면 해당 줄 바로 위아래를 함께 확인하세요.
예시 2: 작은따옴표 사용
JSON 키와 문자열 값은 반드시 큰따옴표를 써야 합니다.
JavaScript 객체를 복사해 왔다면 작은따옴표를 큰따옴표로 바꾸세요.
예시 3: 마지막 trailing comma
객체나 배열 마지막의 쉼표를 허용하지 않는 파서가 많습니다.
마지막 쉼표를 지우고 다시 검증하세요.
- 오류: {"name":"Ana",}
- 정상: {"name":"Ana"}
- 오류: [1,2,3,]
- 정상: [1,2,3]
반복 가능한 디버깅 루틴
JSON Formatter에 붙여넣고 자동 정렬을 먼저 실행하세요.
첫 번째 오류 하나만 고치고 다시 검증하면, 추측 수정보다 훨씬 빠르게 해결됩니다.
이 가이드가 유용한 상황
- API 요청 본문 디버깅
- 설정 파일 JSON 오류 수정
- 웹훅 테스트 데이터 점검
- 초보자 문법 오류 교육
오류를 순서대로 읽기
오류 위치와 기대한 토큰을 먼저 확인하면 대부분 빠르게 해결됩니다. 먼저 포맷하고 일찍 검증하세요.