JSON 포맷터 & 검증기

JSON이란 무엇이고 왜 문법이 엄격한가

JSON(JavaScript Object Notation)은 데이터를 텍스트로 주고받기 위한 형식으로, 국제 표준 ECMA-404와 IETF RFC 8259에 규정되어 있습니다. 이름에 JavaScript가 들어가지만 언어에 종속되지 않아 파이썬, 자바, Go, PHP 등 거의 모든 언어에서 같은 방식으로 읽고 쓸 수 있고, 웹 API와 설정 파일의 사실상 공통어가 되었습니다. 문법이 극도로 단순하고 엄격한 이유는 서로 다른 시스템이 같은 텍스트를 같은 데이터로 해석해야 하기 때문입니다. "대충 알아듣는" 여지를 없앤 대신, 사람이 손으로 쓸 때 쉼표나 따옴표 하나만 틀려도 전체가 거부됩니다. 이 도구는 그 거부 이유를 사람이 알아볼 수 있는 위치와 설명으로 바꿔 주는 역할을 합니다.

JSON에 쓸 수 있는 값은 6가지뿐

날짜·시간 전용 타입이 없어서 보통 ISO 8601 문자열(예: 2025-01-01T00:00:00Z)이나 유닉스 타임스탬프 숫자로 표현합니다. 바이너리 데이터도 직접 담을 수 없어 Base64 문자열로 바꿔 넣는 것이 일반적입니다.

자주 나는 문법 오류와 해결법

아래 여덟 가지가 실무에서 보는 오류의 대부분입니다. 이 도구는 오류가 났을 때 입력 내용을 훑어 해당될 만한 항목을 "의심되는 원인"으로 따로 알려 줍니다.

오류 위치는 어떻게 계산하나요?

브라우저의 JSON 파서는 "위치 N에서 오류"처럼 글자 순번(0부터 센 인덱스)을 알려 주거나, 최신 엔진은 줄과 칸까지 알려 줍니다. 이 도구는 순번만 주어지면 그 앞부분의 줄바꿈 개수를 세어 줄 번호를, 마지막 줄바꿈 이후의 글자 수로 칸 번호를 계산하고, 해당 줄을 미리보기로 보여 주며 문제 위치에 표시를 붙입니다. 중요한 점은 파서가 보고하는 위치는 "문제를 처음 알아챈 곳"이지 "실수를 한 곳"이 아닐 수 있다는 것입니다. 예를 들어 쉼표를 빠뜨린 경우 오류는 쉼표가 있어야 할 자리가 아니라 그 다음 글자에서 보고됩니다. 표시된 위치의 바로 앞부분도 함께 살펴보세요. 브라우저마다 오류 문구와 위치 표기 방식이 다르므로, 위치 정보를 얻지 못한 경우에는 원문 메시지와 위의 원인 점검만 제공합니다.

정렬(Pretty)과 압축(Minify)은 언제 쓰나

두 형식은 의미가 완전히 같고 공백만 다릅니다. 사람이 읽고 수정하는 설정 파일·로그 분석에는 정렬, 네트워크로 보내거나 URL·환경변수·쿠키에 담을 때는 압축이 적합합니다. 아래는 이 페이지가 빌드될 때 같은 데이터를 직접 변환해 측정한 크기입니다(UTF-8 기준 바이트, 한글은 글자당 3바이트).

{
  "name": "홍길동",
  "age": 30,
  "tags": [
    "a",
    "b"
  ],
  "address": {
    "city": "서울"
  }
}

예시 데이터는 압축하면 공백 2칸 정렬본보다 약 35% 작아집니다. 이 차이는 데이터에 중첩이 많을수록 커지지만, 서버가 gzip·Brotli 같은 압축 전송을 쓴다면 전송량 차이는 훨씬 줄어듭니다. 탭이 공백보다 작은 이유는 들여쓰기 한 단계가 1바이트이기 때문입니다.

검산된 예시 세 가지: 변환 시 값이 바뀌는 경우

JSON은 "텍스트 → 값 → 텍스트" 과정을 거치므로, 형식 변환만 했는데도 내용이 달라지는 경우가 있습니다. 아래는 모두 이 페이지 빌드 때 실제로 실행한 결과입니다.

예시 1. 큰 정수의 정밀도 손실

입력 {"id":12345678901234567890}를 파싱한 뒤 다시 출력하면 id가 12345678901234567000로 바뀝니다. 자바스크립트의 숫자는 64비트 부동소수점이라 안전하게 표현할 수 있는 정수가 9007199254740991(2^53−1)까지이기 때문입니다. 트위터·SNS의 글 ID, 주문 번호처럼 16자리를 넘는 정수는 문자열("12345678901234567890")로 주고받는 것이 정석입니다. 이 도구는 입력에서 안전 범위를 넘는 정수를 발견하면 경고를 표시합니다.

예시 2. 키 순서, 중복 키, 숫자 표기

{"b":1,"2":2,"1":3}는 출력하면 {"1":3,"2":2,"b":1}이 됩니다. 자바스크립트 엔진은 "1", "2"처럼 정수 형태의 키를 먼저 오름차순으로 내보내기 때문에, 원본의 키 순서가 이런 경우에는 보존되지 않습니다. 또 {"a":1,"a":2}처럼 같은 키가 두 번 나오면 표준은 키가 유일해야 한다고 권고할 뿐 처리 방식을 정하지 않으며, 이 도구(브라우저)는 마지막 값만 남겨 {"a":2}이 됩니다. 숫자는 [0.1,1e3,1.0,-0]가 [0.1,1000,1,0]으로 바뀝니다. 1e3은 1000, 1.0은 1, −0은 0으로 정규화됩니다. 값의 의미는 같지만 글자 하나까지 같아야 하는 서명·해시 검증용 데이터에는 이 도구의 정렬 결과를 쓰지 마세요.

예시 3. 키 이름순 정렬로 두 JSON 비교하기

서로 다른 시스템이 같은 데이터를 키 순서만 다르게 내보내면 눈으로는 비교가 어렵습니다. 두 JSON을 각각 "키 이름순 정렬 + 정렬(Pretty)"로 변환한 뒤 텍스트 비교 도구에 넣으면 실제로 값이 다른 부분만 남습니다. 배열은 순서가 의미를 가지므로 정렬하지 않고 그대로 두며, 객체의 키만 재귀적으로 정렬합니다.

이 도구의 한계와 쓰면 안 되는 경우

• 표준 JSON만 지원합니다. 주석과 끝 쉼표를 허용하는 JSON5, JSONC(VS Code 설정 파일 등)는 이 도구에서 오류로 나옵니다. 먼저 주석을 지우세요.
• 한 줄에 한 JSON이 이어지는 JSON Lines(NDJSON) 로그는 전체를 한 번에 붙이면 오류가 납니다. 한 줄씩 검증하세요.
• 수십 MB 이상의 파일은 브라우저가 멈출 수 있습니다. 대용량 데이터는 jq 같은 명령줄 도구나 에디터를 쓰세요.
• 검증은 문법만 확인합니다. 필요한 키가 있는지, 값의 타입이 맞는지는 JSON Schema 같은 별도의 스키마 검증이 필요합니다.
• 비밀번호·토큰·개인정보가 든 JSON도 이 도구는 서버로 보내지 않지만, 공용 PC나 화면 공유 중에는 붙여 넣지 않는 편이 안전합니다.

결과를 어떻게 활용하나

• API 요청이 400 오류로 거부될 때: 요청 본문을 검증해 문법 오류를 먼저 배제하고, 그다음 서버가 요구하는 필드를 점검합니다.
• 설정 파일 수정 후: 저장 전에 검증만 눌러 앱이 시작되지 않는 사고를 막습니다.
• CSV와 오가야 할 때: CSV↔JSON 변환기를 사용하세요.
• JWT 토큰의 내용을 보고 싶을 때: 페이로드는 Base64URL로 인코딩된 JSON이므로 JWT 디코더로 해독한 뒤 여기에 붙여 정렬해 읽을 수 있습니다.
• 로그에서 특정 패턴만 뽑을 때: 정규식 테스터와 함께 쓰면 편합니다.

자주 묻는 질문