JSON 유효성 검사 방법: 일반적인 오류와 수정

API가 400 오류를 반환합니다. 로그에는 "Invalid JSON"이라고 나옵니다. 페이로드를 보면 모든 것이 괜찮아 보입니다 — 47번째 줄에 숨어있는 작은따옴표를 발견할 때까지. JSON 유효성 검사 오류는 모든 것을 깨뜨리는 작은 실수인 경우가 많기에 정확히 답답합니다.

가장 일반적인 JSON 구문 오류

1. 후행 쉼표

JSON 실수 1위. JavaScript는 후행 쉼표를 허용하므로, 개발자들이 유효하지 않은 JSON에도 그 습관을 가져갑니다.

{
  "name": "Alex",
  "age": 30
}

마지막 값 뒤의 쉼표를 항상 제거하세요.

2. 쌍따옴표 대신 작은따옴표

JSON은 쌍따옴표를 요구합니다. 이것은 유효한 JavaScript이지만 유효하지 않은 JSON입니다: {'name': 'Alex'}. 모든 작은따옴표를 쌍따옴표로 교체하세요.

3. 인용되지 않은 키

JSON의 모든 키는 인용된 문자열이어야 합니다. {name: "Alex"}는 {"name": "Alex"}가 되어야 합니다.

4. 요소 간 쉼표 누락

JSON을 수동으로 편집할 때 놓치기 쉬운 것 — 키-값 쌍 사이의 쉼표를 잊는 것.

5. 불일치하는 괄호

{를 열고 ]로 닫거나, 잘못된 중첩. 일치하는 괄호를 강조하는 JSON 유효성 검사기를 사용하세요.

효과적인 JSON 유효성 검사 방법

빠른 수동 검증

JSON 유효성 검사기에 JSON을 붙여넣으세요. 오류의 정확한 줄과 문자 위치를 강조합니다. 모든 처리는 브라우저에서 이루어지며 — 데이터가 기기를 떠나지 않습니다.

프로그래밍 방식 유효성 검사

애플리케이션에서 모든 경계에서 JSON의 유효성을 검사하세요. JavaScript에서는 JSON.parse()를 try-catch로 감싸세요. Python에서는 예외 처리와 함께 json.loads()를 사용하세요.

스키마 유효성 검사

구문 유효성 검사는 JSON이 올바른 형태인지 알려줍니다. 스키마 유효성 검사는 올바른 구조를 가지고 있는지 알려줍니다. JSON 스키마 검사기를 사용하여 예상 형태를 정의하세요.

JSON 오류 단계별 디버깅

먼저 포맷하기 — JSON 포맷터에 붙여넣어 적절한 들여쓰기를 얻으세요
오류 위치 확인 — 대부분의 파서가 줄과 열을 보고합니다
일반적인 용의자 찾기 — 후행 쉼표, 작은따옴표, 인용되지 않은 키
점진적 검증 — 대용량 JSON의 경우 섹션별로 별도 검증
버전 비교 — 작동하는 버전과 JSON Diff로 비교

자동화된 유효성 검사 설정

편집기에서

JSON 구문 강조, 린터, 설정 파일의 스키마 유효성 검사를 활성화하세요.

CI 파이프라인에서

병합 전 오류를 잡기 위해 빌드 프로세스에 JSON 유효성 검사를 추가하세요.

API에서

들어오는 JSON을 절대 신뢰하지 마세요. API 경계에서 구문과 스키마 모두를 검증하세요. 도움이 되는 오류 메시지를 반환하세요.

자주 묻는 질문

JSON 유효성 검사와 JSON Schema 유효성 검사의 차이점은 무엇인가요?

JSON 유효성 검사는 구문(적절한 따옴표, 괄호, 쉼표)을 확인합니다. JSON Schema 유효성 검사는 구조를 확인합니다 — 올바른 필드, 올바른 타입, 올바른 제약 조건.

JavaScript에서는 작동하는 JSON이 다른 파서에서 실패하는 이유는 무엇인가요?

JavaScript는 JSON 사양보다 더 관대합니다. 후행 쉼표, 작은따옴표, 주석을 허용합니다. 엄격한 파서는 이 모든 것을 거부합니다.