JSON Lint 디버깅 5단계 — 콤마·따옴표·이스케이프 에러 빠르게 찾기

API 응답에서 JSON parse 에러 만나면 막막하죠. 그런데 실무에서 보는 JSON 에러 95%는 5가지 패턴 안에 들어가요. 이 5가지만 알면 디버깅 시간 90% 줄어들어요. Toolkio JSON 포맷터에 의심 JSON 붙여넣고 단계별로 체크하면 어디가 문제인지 즉시 알 수 있어요.

**단계 1 — 후행 콤마 (Trailing Comma)** 가장 흔한 에러. JSON 표준은 후행 콤마 미허용. ```json // 에러 { "name": "홍길동", "age": 30, ← 마지막 요소 뒤 콤마 } // 정상 { "name": "홍길동", "age": 30 } ``` JavaScript 객체에선 허용되지만 JSON은 엄격. ESLint·Prettier가 자동으로 잡아내지만 수동 작성 시 주의. **단계 2 — 따옴표 종류** JSON은 큰따옴표(")만 허용. 작은따옴표(') 사용 시 에러. ```json // 에러 { 'name': 'value' } // 정상 { "name": "value" } ``` 복사해서 붙여넣을 때 스마트 따옴표(“”)로 변환되는 사고도 있음. 일반 큰따옴표(") 확인.

**단계 3 — 이스케이프 누락** 특수 문자는 백슬래시 이스케이프 필수. ```json // 에러 { "path": "C:\Users\test" } // 정상 { "path": "C:\\Users\\test" } ``` **자주 놓치는 이스케이프 5가지** - `\"` → 큰따옴표 - `\\` → 백슬래시 - `\n` → 줄바꿈 - `\t` → 탭 - `\u0000` → 유니코드 **단계 4 — BOM (Byte Order Mark)** UTF-8 with BOM으로 저장된 파일은 첫 바이트에 보이지 않는 문자(EF BB BF)가 있어요. JSON 파서가 첫 문자를 못 읽어서 에러. **해결법** - 텍스트 에디터에서 'UTF-8 (BOM 없이)' 옵션으로 저장 - VSCode: 우하단 인코딩 → UTF-8 선택 (UTF-8 with BOM 아님) - Notepad++: 인코딩 → UTF-8 (without BOM) 선택

**단계 5 — 중복 키 (Duplicate Keys)** JSON 표준은 중복 키 처리가 모호. 일부 파서는 마지막 값만 받고, 일부는 에러. ```json // 위험 { "name": "A", "name": "B" ← 중복 } ``` 실무에선 중복 키 자체를 에러로 취급. JSON 검증 도구가 잡아내요. **Toolkio JSON 포맷터 활용 5단계** 1. 의심 JSON 붙여넣기 2. 'Format' 클릭 → 들여쓰기 정리 3. 빨간 에러 표시 → 정확한 행·열 표시 4. 위 5가지 패턴 중 어디 해당하는지 확인 5. 수정 → 재검증 → 통과 시 복사 **팁: 큰 JSON에서 빠르게 찾기** - 1MB 이상 JSON은 화면에서 못 찾음 - Toolkio는 행·열 단위 에러 위치 표시 - 에러 위치 ± 50자 잘라내서 좁게 검사 - 95% 5분 안에 해결됨 JSON 에러는 어렵지 않아요. 5단계만 순서대로 따라가면 거의 다 풀려요.