·1분 읽기
JSON 파싱 에러 10분 수정 — 백엔드 개발자가 매일 만나는 6가지 + 실전 예시
JSON 파싱 에러 가장 흔한 6가지와 빠르게 잡는 법을 실제 에러 메시지와 함께 정리했어요. 포맷터 활용 순서 5단계, JSONL·JSON5 차이까지 한 번에 이해할 수 있어요.
{ }
JSON 포맷터 바로 사용하기
JSON을 예쁘게 정렬하고 검증하세요
→
자주 보는 JSON 에러 6가지
1. Trailing comma (마지막 콤마 남김) → "Unexpected token } in JSON"
2. Single quotes (작은따옴표 사용) → "Unexpected token ' in JSON"
3. Unquoted keys (키에 따옴표 없음) → "Unexpected token u in JSON"
4. Unescaped control character (줄바꿈이 문자열 안에) → "Bad control character"
5. Mismatched brackets (괄호 불균형) → "Unexpected end of JSON input"
6. BOM 문자 삽입 (에디터가 저장 시 추가) → 보이지 않는 첫 문자 오류
대부분 이 6가지 안에 들어가요. 에러 메시지가 모호하면 포맷터에 넣어서 라인 번호 확인이 제일 빨라요.
제 경험상 API 디버깅 시간의 70%는 1번(trailing comma)과 4번(unescaped newline)이에요. 특히 Python dict를 JSON으로 저장할 때 자주 발생해요. json.dumps()를 쓰면 자동 처리되지만 직접 문자열로 쓰면 이 에러가 나요.
구조적으로 잡는 순서
1단계: 포맷터로 정렬해 시각적 문제 확인
2단계: 에러 라인 기준 위·아래 3줄만 보기
3단계: 괄호 쌍 검사 (IDE의 bracket matching 기능)
4단계: 따옴표 정상성 검사 (큰따옴표만 허용)
5단계: JSON Schema로 스키마 검증 (선택)
이 순서만 지키면 10분 안에 대부분 해결돼요.
Toolkio JSON 포맷터 활용
에러 위치를 빨간색으로 표시해주고, 콤마·따옴표·괄호 문제를 자동 감지해요. 포맷팅 후 'Minify'로 한 줄 JSON도 바로 변환돼요. 서버에 데이터 안 보내서 안전해요.