Developer Tools

JSON 포맷팅과 유효성 검사 완전 정복

마지막 쉼표 하나까지 완벽하게 포맷된 JSON이 중요한 이유, 그리고 흔한 구조적 오류를 찾아내는 방법.

5분 읽기

Code editor showing JSON

Javascript Object Notation (JSON) 은 현대 API와 데이터 전송에서 명실상부한 표준입니다. 그러나 JSON은 매우 엄격하기 때문에, 쉼표 하나가 잘못 놓이는 것만으로도 프로덕션 엔드포인트 전체가 중단될 수 있습니다.

이 가이드에서는 JSON 포맷팅의 핵심 규칙들을 살펴봅니다.

JSON 문법 규칙

일반 Javascript 객체와 달리, JSON은 오류에 매우 엄격합니다. 규칙을 어기면 파서가 SyntaxError를 던집니다.

  1. 키는 반드시 큰따옴표로 감싸야 합니다: 'name': 'John'은 유효하지 않습니다. 반드시 "name": "John"으로 작성해야 합니다.
  2. 후행 쉼표 금지: 배열이나 객체의 마지막 항목 뒤에 쉼표를 남길 수 없습니다.
  3. 함수 및 undefined 사용 불가: JSON은 문자열, 숫자, 불리언, 배열, 객체, null만 저장할 수 있습니다.

유효한 JSON vs. 유효하지 않은 JSON

엄격한 JSON 파서가 요구하는 형식을 살펴보겠습니다.

{
  "user": {
    "id": 1042,
    "isActive": true,
    "roles": ["admin", "editor"],
    "preferences": null
  }
}

같은 객체를 JS 스크립트처럼 느슨하게 작성하면 어떻게 될까요:

// 이것은 유효하지 않은 JSON입니다 (하지만 유효한 Javascript)
{
  user: {
    id: 1042,
    isActive: true, // 후행 쉼표
  }
}

유효성 검사가 중요한 이유

마이크로서비스를 연결할 때 유효하지 않은 JSON을 전달하면, JSON.parse()가 치명적으로 실패하면서 수신 서버가 대규모 500 에러를 던집니다. 애플리케이션에 JSON을 추가하기 전에 항상 린트 및 포맷팅을 진행하세요.

자동화된 포맷팅 도구를 활용해 API 페이로드가 안전하고 구조적으로 올바른지 검증하세요!

데이터를 테스트할 준비가 되셨나요? JSON Formatter & Validator로 이동해 원시 문자열을 즉시 보기 좋게 변환해 보세요!