JSON검증문법 오류개발자API
✅개발자 도구 없이 JSON 검증하는 법 — 온라인 도구 완벽 가이드
API 응답을 받았는데 파싱이 안 되거나, 설정 파일을 수정했더니 프로그램이 실행되지 않는 경우 대부분 JSON 문법 오류가 원인입니다. 브라우저 개발자 도구를 열지 않고도 온라인에서 즉시 JSON 문법을 검증하는 방법을 알아봅니다.
JSON 검증이 필요한 상황
| 상황 | 증상 |
|---|---|
| API 응답 파싱 실패 | SyntaxError: Unexpected token |
| package.json 오류 | npm install 또는 npm start 실패 |
| 설정 파일(.eslintrc, tsconfig) 오류 | 빌드 도구 실행 실패 |
| 데이터 임포트 실패 | JSON 파일 로드 오류 |
| REST API 요청 본문 오류 | 400 Bad Request 응답 |
자주 발생하는 JSON 오류 유형
| 오류 유형 | 잘못된 예 | 올바른 예 |
|---|---|---|
| 키에 따옴표 없음 | {name: "홍길동"} | {"name": "홍길동"} |
| 작은따옴표 사용 | {'name': '홍길동'} | {"name": "홍길동"} |
| 마지막 쉼표 (Trailing comma) | {"a": 1, "b": 2,} | {"a": 1, "b": 2} |
| 주석 포함 | {"a": 1 // 주석} | {"a": 1} |
| undefined 사용 | {"val": undefined} | {"val": null} |
| 함수 포함 | {"fn": function(){}} | JSON에는 함수 불가 |
온라인 JSON 검증 방법
- 검증할 JSON 텍스트 복사
- txtool 개발자 도구 → JSON 포맷터/검증 탭 열기
- 텍스트 붙여넣기
- 오류 위치와 오류 메시지 확인
- 오류 수정 후 재검증
JavaScript 콘솔로 검증하기
브라우저 콘솔(F12)이나 Node.js 터미널에서도 빠르게 검증 가능합니다.
// 브라우저 콘솔 또는 Node.js
try {
JSON.parse('{"name": "홍길동"}')
console.log("유효한 JSON")
} catch(e) {
console.error("오류:", e.message)
// SyntaxError: Unexpected token } in JSON at position 25
}
// 오류 메시지에서 position 숫자로 오류 위치 파악
오류 메시지 해독법
| 오류 메시지 | 원인 |
|---|---|
| Unexpected token , | trailing comma (마지막 쉼표) |
| Unexpected token u | undefined 사용 |
| Unexpected token ' | 작은따옴표 사용 |
| Unexpected end of JSON | 중괄호/대괄호 닫힘 누락 |
| Expected property name | 키에 따옴표 없음 |
JSON 검증 자동화
// package.json 스크립트에 검증 추가 // prettier로 JSON 포맷팅 + 검증 npx prettier --check "**/*.json" // ESLint JSON 플러그인 // eslint-plugin-jsonc 설치 후 // .eslintrc.json에 extends: ["plugin:jsonc/recommended"] 추가
자주 묻는 질문
JSONC(JSON with Comments)는 어떻게 검증하나요?
일반 JSON 검증 도구로는 주석이 있는 JSONC를 검증할 수 없습니다. VS Code에서 파일 언어 모드를 "JSON with Comments"로 바꾸거나, jsonc-parser 라이브러리를 사용하세요. tsconfig.json, .vscode/settings.json이 대표적인 JSONC 파일입니다.
JSON 파일이 너무 커서 붙여넣기가 안 되면?
Node.js 터미널에서 JSON.parse(require('fs').readFileSync('파일명.json', 'utf8'))을 실행하면 대용량 파일도 검증할 수 있습니다. 또는 jq 명령줄 도구를 사용하면 cat 파일.json | jq . 명령으로 검증과 포맷팅을 동시에 할 수 있습니다.
JSON 스키마 검증은 무엇인가요?
JSON 스키마(JSON Schema)는 JSON 데이터의 구조와 타입을 정의하는 표준입니다. 단순 문법 검증을 넘어 "name 필드는 반드시 문자열이어야 한다", "age는 0 이상 정수여야 한다" 같은 규칙을 검증할 수 있습니다. ajv 라이브러리나 jsonschema.net 온라인 도구를 활용하세요.