JSON 검증 방법: 완벽 가이드와 예제

JSON(JavaScript 객체 표기법)은 현대 Web API, 구성 파일 및 데이터 교환의 초석입니다. 그러나 유효하지 않은 JSON은 애플리케이션 충돌, API 통합 실패 및 수 시간의 디버깅 고통을 초래할 수 있습니다. 이 가이드는 기본 구문 검사부터 실제 예제를 사용한 고급 Schema 검증까지, JSON 검증에 필요한 모든 것을 안내합니다.

JSON 검증이 중요한 이유

유효하지 않은 JSON은 웹 애플리케이션에서 가장 흔한 오류 원인 중 하나입니다. 잘못 배치된 쉼표, 따옴표가 없는 키 또는 후행 쉼표 하나만으로도 JSON.parse()가 SyntaxError를 발생시켜 전체 데이터 파이프라인이 중단될 수 있습니다. 검증은 이러한 오류가 시스템에 전파되어 다운스트림 장애를 일으키기 전에 조기에 포착할 수 있습니다.

구문 정확성 외에도 검증은 JSON 데이터가 예상된 구조를 준수하는지 확인합니다. API가 유효한 JSON을 반환할 수 있지만 필수 필드가 누락되거나, 데이터 유형이 잘못되거나, 값이 허용 범위를 벗어날 수 있습니다. Schema 검증은 이러한 구조적 문제를 해결합니다.

애니메이션은 @keyframes 규칙을 사용하여 임의 개수의 단계로 스타일 변화 시퀀스를 정의합니다. 전환과 달리, 애니메이션은 상태 변화와 독립적으로 실행되고, 무한 반복되고, 역방향 재생되고, 일시 정지될 수 있습니다. 애니메이션의 모든 프레임을 정밀하게 제어할 수 있습니다.

검증 도구를 깊이 살펴보기 전에 JSON을 유효하게 만드는 규칙을 이해하는 것이 중요합니다. JSON은 RFC 8259에 의해 정의된 엄격한 구문을 가지고 있으며, 단일 문자 위반으로도 전체 문서가 무효화될 수 있습니다.

중요: meta 태그는 보고 전용 모드에 사용할 수 없습니다. 강제 적용 전에 정책을 테스트해야 하는 경우 HTTP 헤더 방식을 사용해야 합니다. 또한 meta 태그는 하나의 CSP 정책만 지원하는 반면, HTTP 헤더는 여러 정책을 전달할 수 있습니다.

모든 문자열 값과 객체 키는 큰따옴표로 감싸야 합니다. 작은따옴표는 유효한 JSON 문자열 구분자가 아니며, 이는 JavaScript에서 넘어온 개발자들이 흔히 저지르는 실수입니다.

// Invalid - single quotes
{'name': 'Alice', 'age': 30}

// Valid - double quotes
{"name": "Alice", "age": 30}

객체 키는 따옴표로 감싸야 함

JavaScript 객체 리터럴과 달리 JSON은 모든 객체 키를 큰따옴표로 감싸야 합니다. 따옴표가 없는 키는 구문 오류입니다.

// Invalid - unquoted keys
{name: "Alice", age: 30}

// Valid - quoted keys
{"name": "Alice", "age": 30}

후행 쉼표 불허

JSON은 객체나 배열의 마지막 항목 뒤에 쉼표를 허용하지 않습니다. 이는 특히 JSON을 수동으로 편집할 때 또 다른 일반적인 오류입니다.

// Invalid - trailing comma
{
  "name": "Alice",
  "age": 30,
}

// Valid - no trailing comma
{
  "name": "Alice",
  "age": 30
}

주석 지원 안 함

JSON은 주석을 지원하지 않습니다. // 한 줄 주석과 /* */ 여러 줄 주석은 JSON에서 모두 유효하지 않습니다. 문서 설명이 필요한 경우 별도의 파일이나 JSONC와 같은 형식을 사용하세요.

자주 묻는 질문

가장 흔한 오류를 이해하면 빠르게 발견하고 수정할 수 있습니다. 다음은 가장 자주 접하게 되는 오류입니다:

• 예상치 못한 토큰: 일반적으로 작은따옴표, 따옴표가 없는 키 또는 후행 쉼표로 인해 발생합니다. 오류 메시지에는 구문 분석이 실패한 위치가 포함됩니다.
• JSON 입력의 예상치 못한 종료: JSON 문자열이 불완전하거나 비어 있습니다. 이는 일반적으로 네트워크 요청이 빈 응답을 반환할 때 발생합니다.
• 예상치 못한 비공백 문자: 주 JSON 값 뒤의 추가 콘텐츠로, 예를 들어 배열로 감싸지 않은 두 번째 객체입니다.
• 유효하지 않은 숫자: 앞에 0이 붙은 숫자(0 자체 제외), 16진수 표기법 또는 NaN/Infinity 값은 유효한 JSON이 아닙니다.

JavaScript에서 JSON 검증하기

JavaScript에서 JSON을 검증하는 가장 간단한 방법은 JSON.parse()를 try-catch 블록으로 감싸는 것입니다. JSON이 유효하지 않으면 이 메서드는 SyntaxError를 발생시킵니다.

function validateJSON(jsonString) {
  try {
    JSON.parse(jsonString);
    return { valid: true };
  } catch (error) {
    return {
      valid: false,
      error: error.message
    };
  }
}

const result = validateJSON('{"name": "Alice"}');
console.log(result);
// { valid: true }

const badResult = validateJSON("{'name': 'Alice'}");
console.log(badResult);
// { valid: false, error: "Unexpected token '..." }

Python에서 JSON 검증하기

Python은 json 모듈을 제공하며, 여기에는 JSON 문자열을 구문 분석하는 json.loads()가 포함됩니다. JavaScript와 유사하게, 유효하지 않은 JSON은 상세한 위치 정보와 함께 json.JSONDecodeError를 발생시킵니다.

import json

def validate_json(json_string):
    try:
        json.loads(json_string)
        return {"valid": True}
    except json.JSONDecodeError as e:
        return {
            "valid": False,
            "error": str(e),
            "line": e.lineno,
            "column": e.colno
        }

result = validate_json('{"name": "Alice"}')
print(result)
# {'valid': True}

JSON Schema 검증

구문 검증은 JSON이 올바른 형식인지만 알려줍니다. JSON Schema는 예상 구조를 정의하고 그에 따라 데이터를 검증할 수 있게 해줍니다. Schema는 필수 필드, 데이터 유형, 값 범위, 문자열 패턴 및 중첩 객체 구조를 지정합니다.

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "required": ["name", "email"],
  "properties": {
    "name": { "type": "string", "minLength": 1 },
    "email": { "type": "string", "format": "email" },
    "age": { "type": "integer", "minimum": 0 }
  }
}

인기 있는 JSON Schema 검증기로는 JavaScript의 Ajv, Python의 jsonschema, Java의 json-schema-validator가 있습니다. 이러한 라이브러리는 Schema에 따라 JSON 데이터를 검증하고 각 위반에 대해 상세한 오류 메시지를 생성합니다.

온라인 도구 사용하기

코드를 작성하지 않고 JSON 문서를 빠르게 확인해야 할 때 온라인 검증기가 가장 빠른 선택입니다. 오류 강조 표시와 줄 번호가 포함된 즉각적인 피드백을 제공합니다.

플레이스홀더 텍스트 대비 부족: 폼 필드의 플레이스홀더 텍스트는 대비가 매우 낮은 경우가 많습니다. WCAG는 플레이스홀더 텍스트가 대비 비율을 충족할 것을 요구하지 않지만(실제 콘텐츠가 아니므로), 가독성을 보장하는 것이 모범 사례입니다.

• 조기에 검증하세요: 데이터가 비즈니스 로직에 들어가기 전에 시스템 경계(API 엔드포인트 및 파일 가져오기 함수 등)에서 JSON을 확인하세요.
• Schema 검증 사용: 구문 외에도 JSON Schema를 사용하여 데이터 구조를 검증하고, 누락된 필드, 잘못된 유형 및 범위를 벗어난 값을 포착하세요.
• 명확한 오류 메시지 제공: 검증이 실패하면 필드 경로, 예상 유형 및 실제 값을 포함하여 사용자가 문제를 빠르게 수정할 수 있도록 도와주세요.
• 클라이언트와 서버 양쪽에서 검증하세요: 클라이언트 측 검증은 즉각적인 피드백을 제공하고, 서버 측 검증은 보안과 데이터 무결성을 보장합니다.
• CI/CD에서 검증 자동화: ajv-cli 또는 jsonschema와 같은 도구를 사용하여 빌드 파이프라인에서 JSON 픽스처 파일과 구성 파일을 검증하세요.
• 검증 오류 기록: 컨텍스트와 함께 검증 실패를 기록하여 패턴을 식별하고 데이터 생산자의 근본 원인을 수정하세요.