JSON 정리·검증 사용법: 쉼표·따옴표 오류부터 확인하세요
JSON을 붙여 넣었는데 오류가 나면 괄호를 임의로 지우기 전에 오류가 표시된 위치와 바로 앞의 쉼표·따옴표를 확인하세요. JSON 정리는 읽기 쉽게 들여쓰는 작업입니다. 문법을 통과했다는 사실만으로 금액·주문번호·필수 항목까지 맞는 것은 아닙니다.
왜 오류가 날까요?
JSON의 이름과 문자열은 큰따옴표로 감쌉니다. 마지막 항목 뒤에 쉼표를 붙이거나 JavaScript 코드처럼 작은따옴표·주석을 쓰면 JSON 문법과 맞지 않습니다. 문자열 안의 쉼표는 값의 일부이므로 ‘쉼표 전부 삭제’로 고치지 마세요. JSON 표준 RFC 8259, MDN JSON.parse 안내
작은 합성 예제로 비교하기
정상 예제는 실제 주문 자료가 아닌 합성 데이터입니다.
{"order_id":"00123","qty":2,"memo":"red, blue","approved":false,"coupon":null}| 예제 | 입력에서 볼 것 | 이 예제의 확인 결과 |
|---|---|---|
| 정상 | 위 예제 | 문법 통과. order_id는 문자열, qty는 숫자 |
| 마지막 쉼표 | {"qty":2,} | 닫는 중괄호 앞 쉼표 오류 |
| 작은따옴표 | {'qty':2} | 이름의 따옴표 오류 |
| 콜론 누락 | {"qty" 2} | 이름과 값 사이 콜론 오류 |
| 값 의미 비교 | {"qty":"2","coupon":"null"} | 문법 통과지만 숫자 2·null과 다른 문자열 |
false, null, 숫자 0, 빈 문자열 ""은 서로 다른 값입니다. 업무상 무엇을 허용할지는 받는 시스템의 규격에서 확인하세요. 문자열 안에 실제 줄바꿈을 넣는 대신 \n으로 표현하는 규칙도 구분합니다. JSON 값·문자열 규칙
도구에서 확인하는 순서
- 원본을 따로 보관합니다. 고객 자료·인증 토큰·비밀번호 대신 위 합성 예제로 먼저 익히세요.
- JSON 정리·검증에 내용을 붙여 넣거나 JSON 파일을 고릅니다. 붙여 넣은 내용은 자동 점검되며 정리하기로도 실행할 수 있습니다.
- 오류가 나면 표시된 줄·칸과 앞뒤 내용을 확인합니다. 표시 위치는 고쳐야 할 범위를 찾는 단서이며, 진짜 원인이 바로 앞 항목에 있을 수도 있습니다. 원본 사본에서 한 가지씩 수정합니다.
- 통과하면 들여쓰기를 공백 2칸·4칸·탭 중 고르거나 한 줄로를 선택합니다. 정상 예제는 2칸 들여쓰기에서 다음처럼 보입니다.
{
"order_id": "00123",
"qty": 2,
"memo": "red, blue",
"approved": false,
"coupon": null
}- 복사하거나 새 JSON 파일로 내려받기 전에 주문번호
00123, 메모red, blue, 숫자·문자열 구분을 원본과 대조합니다. 원본 파일에 덮어쓰지 않습니다.
정리 도구는 내용을 브라우저 안에서 처리하도록 구현돼 있습니다. 이 설명은 입력 내용의 처리에 대한 것으로, 사이트의 방문 통계·호스팅 접속 기록과는 구분합니다. 자세한 범위는 개인정보 안내에서 확인하세요.
‘올바른 JSON’이어도 확인해야 할 두 경우
중복 키: {"qty":2,"qty":3}은 업무상 어느 수량이 맞는지 불분명합니다. 이 도구는 같은 객체 안의 중복 키를 찾으면 정리 결과 위의 주황색 경고 상자에 키 이름·줄·칸과 마지막 값만 남는다는 안내를 표시합니다. 문법 오류로 거절하지는 않으며, 이 예제의 정리 결과에는 {"qty":3}만 남습니다. 서로 다른 객체에 같은 키가 있는 경우와 구분합니다. 정리한 결과로 원본을 덮어쓰지 마세요. 중복 이름을 피하라는 표준 권고와도 구분해야 합니다. RFC 8259 객체 이름 안내
큰 정수: {"order_id":9007199254740993}은 정리 결과 위의 주황색 상자에 큰 정수 경고가 표시되며, 정리 결과의 숫자는 9007199254740992로 바뀝니다. 긴 식별자는 제공처와 합의한 문자열 형식, 예를 들어 {"order_id":"9007199254740993"}로 전달받는 편이 안전합니다. 이미 손상된 숫자를 나중에 따옴표로 감싼다고 복구되지는 않습니다. JSON.parse의 숫자 정밀도 주의
이 도구는 중복 키나 큰 정수 경고가 있으면 ‘올바른 JSON입니다’ 바로 아래, 정리 결과 위에 주황색 상자를 표시합니다. 제목은 ‘정리 결과가 원문과 다를 수 있습니다’입니다. 큰 정수 경고에는 정확히 다룰 수 있는 범위 ±9,007,199,254,740,991, 입력 숫자·정리 결과 숫자와 줄·칸이 나옵니다. 위치는 입력 내용과 공백·줄바꿈에 따라 달라지므로 다른 예제의 줄·칸을 그대로 적용하지 마세요.
큰 정수가 있으면 “주문번호·ID처럼 계산하지 않는 값은 원본에서 큰따옴표로 감싼 문자열로 두면 그대로 남습니다.”라는 안내를 덧붙입니다. 위 문자열 ID 예제는 큰 정수 경고 대상이 아닙니다. 상자 끝에는 ‘입력한 원문은 바꾸지 않습니다. 정리 결과를 쓰기 전에 원본을 확인하세요.’라고 안내합니다. 원문 입력을 유지한다는 뜻이며, 정리 결과의 값 손실을 자동 복구하거나 출력을 막는다는 뜻이 아닙니다.
이 두 현상은 현재 엔진을 로컬에서 대조한 결과입니다. JSON 정리를 항상 원문 값을 보존하는 변환이라고 소개하지 않습니다. 다른 파서·버전이 같은 방식으로 처리한다고 단정하지도 않습니다.
도구가 판정하지 않는 것
이 도구는 JSON 문법과 들여쓰기를 돕습니다. 업무별 필수 키·허용 값·금액의 정확성·최신 주문 여부를 확인하는 JSON Schema 검사나 업무 검증을 대신하지 않습니다. 출력은 공백·줄바꿈 등 표현이 달라지고, 위 중복 키·숫자 사례처럼 값 정보까지 달라질 수 있습니다. JSON.stringify의 들여쓰기 동작
CSV로 변환하려는 경우 문법 통과 외에 표로 바꿀 수 있는 구조인지 확인해야 합니다. CSV ↔ JSON 변환으로 넘기기 전, 빈 필드와 누락 필드 구분을 함께 확인하세요. JSON 정리 도구의 통과가 CSV 변환 성공을 보장하지 않습니다.
확인 범위
정상·문법 오류·자료형 차이·중복 키·큰 정수 등 작은 합성 입력 12건을 현재 로컬 정리 엔진으로 대조했습니다. 공백 2칸·4칸·탭·한 줄 출력도 확인했습니다. 실제 브라우저 클릭·파일 업로드·다운로드·클립보드·공개 사이트 실행은 이번 원고 검증에 포함하지 않았습니다.
검토일: 2026-10-20. 참고용 합성 예제이며 실제 자료는 제공처 규격과 대조하세요.
AI 보조 작성: AI로 원고와 합성 예제를 작성하고 로컬 코드 결과를 대조했습니다. 실제 고객 자료는 사용하지 않았습니다.