HUB - Updated 2026-05-14
JSON / API Error Center
JSON Unexpected token, trailing comma, unexpected end of input, HTML 응답 혼입 같은 JSON/API 오류를 진단하는 허브.
Open JSON Error DoctorJSON 오류가 났다면 먼저 문법 오류인지, API가 애초에 JSON이 아닌 응답을 보낸 것인지 구분해야 합니다. Unexpected token <처럼 첫 글자가 <인 오류는 JSON 문법보다 HTML 응답 혼입일 가능성이 높습니다. JSON 오류 해결의 핵심은 오류 위치, 첫 글자, 응답 헤더, 실제 응답 본문을 순서대로 확인하는 것입니다.
이 주제가 중요한 이유
JSON은 프론트엔드, 백엔드, 자동화 스크립트, 외부 API 연동에서 가장 흔하게 쓰이는 데이터 형식입니다. 하지만 오류 메시지는 짧고 추상적인 경우가 많아, 쉼표 하나 문제인지 인증 실패 페이지가 HTML로 온 것인지 빠르게 구분하기 어렵습니다.
문제를 잘못 분류하면 코드를 계속 고쳐도 해결되지 않습니다. 예를 들어 로그인 만료로 HTML 로그인 페이지가 반환되는 상황에서 JSON parser만 확인하면 시간을 낭비하게 됩니다.
가장 흔한 문제
| 문제 | 흔한 원인 | 먼저 확인할 것 |
|---|---|---|
| Unexpected token | 잘못된 문자, 따옴표, 쉼표 | 오류 위치와 주변 문자 |
| Unexpected token < | HTML 응답을 JSON으로 파싱 | 응답 첫 글자와 status code |
| trailing comma | 마지막 항목 뒤 쉼표 | 닫는 중괄호/대괄호 앞 쉼표 |
| unexpected end of input | 닫히지 않은 객체/배열/문자열 | 응답이 중간에 끊겼는지 |
| JSON이 아닌 API 응답 | 인증 실패, 404, 프록시 오류 | Content-Type과 response body |
바로 쓰는 도구
JSON Error Doctor는 JSON을 붙여넣으면 정상 여부를 확인하고, 오류 위치와 대표 원인을 보여줍니다. 정상 JSON은 pretty format 또는 minify로 정리할 수 있습니다.
API 디버깅 중이라면 브라우저 Network 탭이나 터미널에서 실제 응답 본문을 복사해 도구에 넣어보는 방식이 빠릅니다.
에러별 해결 문서
- JSON Unexpected token 오류
- Unexpected token < in JSON at position 0
- JSON trailing comma 오류
- JSON unexpected end of input
- API 응답이 JSON이 아니라 HTML일 때
기초 가이드
심화 칼럼 예정
- JSON 오류 메시지 20개를 실제 예제로 비교
- 다국어 웹 도구에서 클라이언트 처리와 서버 처리의 장단점
- API 응답 검증 체크리스트 설계
관련 용어
- JSON.parse: 문자열을 JavaScript 값으로 변환하는 동작
- Content-Type: 응답 본문의 형식을 알려주는 HTTP 헤더
- trailing comma: 마지막 항목 뒤에 남은 쉼표
- status code: API 요청 결과를 나타내는 HTTP 상태 코드
- response body: API가 실제로 반환한 본문
업데이트 날짜
2026-05-14