JSON pretty print: invalid JSON을 빠르게 잡는 방법
JSON은 형식이 엄격해서 작은 오타 하나로도 파싱이 실패합니다. 응답 로그나 설정 파일을 검토할 때는 먼저 보기 좋은 형태로 정리하고, 에러 위치를 단계적으로 좁혀 가는 것이 가장 빠릅니다. 실무에서 중요한 것은 "예쁘게 보기"보다 "깨진 위치를 빨리 찾는 것"입니다.
1) Pretty print가 필요한 이유
- 한 줄 JSON은 구조를 파악하기 어렵습니다.
- 들여쓰기만 정리해도 오류가 눈에 띄게 드러납니다.
- 구조가 보이면 누락된 괄호나 쉼표를 찾기 쉬워집니다.
- 중첩이 깊을수록 배열/객체 경계가 분명해집니다.
2) 가장 흔한 오류 패턴
- 마지막 쉼표(trailing comma)
- 따옴표(quote) 누락
- 잘못된 escape(예:
\누락) - 숫자/불리언을 문자열로 잘못 감싼 경우
예를 들어 다음 JSON은 마지막 쉼표 때문에 실패합니다.
{"name":"DevTool","items":[1,2,3],}
3) 디버깅 순서
- 최소 입력을 만들어서 파싱 테스트
- 에러 메시지 기준으로 해당 위치 주변 점검
- 포맷팅 후 구조 확인
- 구조가 복잡하면 일부만 잘라 단계적으로 검증
실제로는 4번이 매우 중요합니다. 2,000줄짜리 JSON 전체를 붙잡고 보기보다, 문제가 의심되는 객체 하나만 남겨 테스트하는 편이 훨씬 빠릅니다.
4) 실무 팁
- API 응답을 그대로 붙여넣기 전에 민감 정보는 마스킹하세요.
- 문자열 안에 줄바꿈이 있다면 이스케이프(
\n) 처리가 되었는지 확인하세요. - JSON과 JavaScript 객체 문법은 다릅니다. 예를 들어 주석은 JSON에서 허용되지 않습니다.
- 복사 과정에서 스마트 따옴표나 보이지 않는 문자가 들어오지 않았는지 확인하세요.
5) 바로 써보기
JSON Formatter & Validator에서 JSON을 붙여넣으면 바로 포맷팅되고, 오류가 있으면 에러 메시지로 위치를 확인할 수 있습니다.
6) 에러 메시지 해석 팁
position X는 문자열 내 인덱스입니다.- 문제가 되는 위치 주변을 20~30자 범위로 잘라서 재검증하면 빠릅니다.
브라우저나 언어 런타임에 따라 행과 열을 같이 보여주는 경우도 있습니다. 하지만 실제 원인은 표시 위치보다 조금 앞에서 발생하는 경우가 많습니다. 예를 들어 누락된 따옴표나 잘못 닫힌 배열은 에러가 다음 토큰에서 드러나는 식입니다.
7) 검증 시나리오
- 입력을 최소화한 뒤 파싱 여부 확인
- 문법 문제를 수정한 뒤 다시 포맷팅
- 실제 JSON 스키마와 비교
- API 문서 예제와 필드 타입을 대조
8) 흔한 실무 원인
사람이 직접 작성한 설정 파일보다, 템플릿 엔진이나 문자열 치환으로 JSON을 만들어서 깨지는 경우가 더 흔합니다. 쉼표 처리, 따옴표 escape, 개행 문자, undefined 같은 JSON 비호환 값이 대표적입니다. 따라서 문제가 반복된다면 수동 수정 대신 JSON 생성 로직 자체를 점검하는 편이 낫습니다.
9) 체크리스트
- 큰따옴표 사용 여부
- 마지막 콤마 제거 여부
- 이스케이프 문자 누락 여부
- 숫자/불리언/null 타입이 문자열로 바뀌지 않았는가
10) 운영 팁
유저 입력을 받아 JSON으로 저장하는 시스템이라면 저장 직전에 검증하고, 에러 메시지를 사용자에게 이해 가능한 형태로 바꾸는 것이 좋습니다. 백엔드에서만 실패시키면 프론트엔드나 운영자가 원인을 다시 추적해야 해서 비용이 커집니다.