JSON 파싱 오류: 메시지를 읽고, 해결로 바로 이동
JSON 파서 오류 메시지와 각각을 설명하는 문서의 디렉터리 —— 먼저 엄격한 검증기로 확인하고, 그다음 구체적인 구문 문제로 파고듭니다.
여기에 도착했다면
코드가 JSON 파서 오류를 던졌고, 정확한 해결 방법을 찾고 싶을 것입니다. 먼저 파서의 메시지를 읽으세요 —— 위치와 의심스러운 문자가 단서입니다. 그런 다음 근본 원인을 설명하는 문서로 이동하고, 엄격한 검증기로 복구된 텍스트가 JSON.parse를 통과하는지 확인하세요.
파서 메시지 읽기
모든 최신 JSON 파서는 위치와 문제가 되는 문자를 보고합니다. 메시지를 아래 목록과 대조하고, 해당 정확한 표현을 다루는 문서를 여세요.
Unexpected token 오류 —— 개요Unexpected token < —— fetch가 HTML을 반환함Unexpected token u —— undefined를 파싱함Unexpected token o —— [object Object]가 문자열화됨Unexpected end of JSON input —— 잘리거나 닫히지 않음JSON 뒤에 공백이 아닌 문자 —— 여분의 데이터, NDJSON?JSON의 종료되지 않은 문자열 —— 따옴표를 열고 닫지 않음JSON의 잘못된 이스케이프 문자 —— \x, Windows 경로문자열 리터럴의 잘못된 제어 문자 —— 원시 탭/줄바꿈[object Object]는 유효한 JSON이 아님큰따옴표 속성 이름이 필요함 —— 후행 쉼표
근본 원인 해결하기
대부분의 파서 오류는 반복적으로 나타나는 다섯 가지 구문 문제 중 하나에서 비롯됩니다. 각 문제의 가이드는 원인, 해결 방법, 그리고 파서를 다시 실행하기 전에 확인할 사항을 설명합니다.
JSON의 후행 쉼표 수정JSON의 작은따옴표 수정JSON의 따옴표 없는 키 수정Unexpected Token 오류 수정 (가이드)Expected Property Name 오류 수정
엄격한 JSON이 엄격한 이유
JSON은 JavaScript 객체 리터럴처럼 보이지만 훨씬 작은 문법입니다. 후행 쉼표 없음, 주석 없음, 작은따옴표 없음, Python 스타일의 True/None 없음. 이 역사적 참고 자료들은 왜 문법이 최소한으로 유지되었는지, 그리고 상호 운용성 결정이 어떻게 이루어졌는지 설명합니다.
RFC 8259 —— 현행 JSON 표준ECMA-404 제2판Parsing JSON is a Minefield (파서 불일치)Bishop Fox —— JSON 상호 운용성 연구Tree-sitter JSON 문법 —— 편집기가 JSON.parse와 다르게 파싱하는 이유
권장 경로
도구에서 가이드, 블로그, 참고 자료까지 하나의 흐름으로: JSON 검증기를 열어 정확한 행과 열을 얻고, 근본 원인 가이드를 읽고, 해당 오류 메시지에 대한 블로그 글을 따라가고, 마지막으로 문법을 정의하는 표준을 찾아보세요.
-
- 도구: /json-validate —— 파싱 오류와 그 위치를 확인.
-
- 가이드: /guides/fix-json-unexpected-token —— 증상을 원인에 연결.
-
- 블로그: /blog/json-parse-unexpected-token —— 토큰 수준 실수의 전체 분석.
-
- 참고: /news/rfc-8259-json-standard —— 문법이 엄격한 이유.
JSON 수리 가이드
토픽 허브
구체적인 가이드
- Base64 문자열 디코드 방법 (그리고 JWT 페이로드)
- URL 인코딩: 쿼리 파라미터와 경로를 퍼센트 인코드하기
- YAML을 JSON으로 변환하기 (그리고 들여쓰기 오류 피하기)
- JSON을 CSV로 변환: 객체 배열을 펴기
- JSON을 XML로 변환: 루트, 속성, 배열
- JSON을 문자열 리터럴로 이스케이프하기 (그리고 이중 인코드된 JSON 디코드)
- JSON의 후행 쉼표 고치기
- JSON의 작은따옴표 고치기
- JSON의 따옴표 없는 키 고치기
- LLM이 만든 JSON 고치기
- JSON 파싱 오류 “Expected Property Name” 고치기
- JSON vs JavaScript 객체 리터럴
- API 요청 전에 JSON 검증하기
- JSON 포맷터 vs JSON Repair
- JSON Unexpected Token 오류 고치기
- JSON에서 JavaScript 객체 변환기