JSON 파일이 문법 오류 없이 열려도 같은 이름의 키가 두 번 있으면 의도한 설정이 남지 않을 수 있습니다. 일부 파서는 마지막 값을 사용하고 다른 도구는 중복을 거부하거나 다르게 처리할 수 있습니다. 파일이 파싱됐다는 신호와 설정의 의미가 맞다는 확인을 나눠야 합니다.
먼저 구분할 조건
JSON 객체의 멤버 이름은 서로 구분되어야 일관되게 전달하기 쉽습니다. 같은 theme 키에 light와 dark를 함께 쓰면 한 객체의 값으로 무엇을 선택할지 해석이 갈릴 수 있습니다. RFC 8259는 중복 이름이 상호운용에 문제가 될 수 있다는 조건을 설명합니다. 모든 파서가 같은 동작을 보장한다고 가정하지 말고 실제 사용하는 도구의 규칙과 필요한 설정 항목을 확인하십시오.

직접 확인한 예제와 방법
{"theme":"light","theme":"dark"}라는 가상 JSON과 theme가 한 번만 있는 정리본을 만들었습니다. Python 3.12.14의 기본 json 파서는 중복 원문의 결과에 theme: dark 한 개를 남겼습니다. 원문 쌍을 읽는 방식에서는 멤버 두 개를 확인했습니다. 브라우저 JSON.parse에서도 결과 멤버는 한 개, 값은 dark였습니다. 실제 프로그램의 테마 설정을 바꾸지 않고 문자열의 파싱 결과만 확인한 시험입니다.
| 확인 항목 | 관찰 결과 |
|---|---|
| 원문 theme 멤버 | 2개 |
| Python 기본 파서 결과 | theme: dark 1개 |
| 브라우저 JSON.parse | theme: dark 1개 |
| 문법 검사만으로 | 중복 의도는 판정 못함 |
결과를 해석하는 기준
기본 파싱 결과만 다시 저장하면 처음에 light와 dark가 함께 있었다는 정보가 사라질 수 있습니다. 원문을 먼저 보존하고 중복 여부를 별도 확인해야 합니다. 현재 결과에 dark 한 개가 있다는 관찰만으로 작성자의 원래 의도를 알아낼 수는 없습니다.
정리본을 만들 때 어느 값을 남길지는 설정의 소유자와 필요한 동작을 확인해 결정해야 합니다. 값을 임의로 첫 번째 또는 마지막으로 고르는 방식은 모순을 감추는 작업이 될 수 있습니다. 주석을 허용하는 변형 형식이나 여러 파일을 합치는 설정 체계도 다른 규칙이 있으므로 일반 JSON의 검사와 나눠 봅니다.
객체 범위와 설정 병합을 구분합니다
작성 예제로 두 개의 서로 다른 하위 객체에 theme가 각각 있는 경우를 생각해 볼 수 있습니다. 같은 이름이 문서에 여러 번 있다는 것만으로 같은 객체의 중복 키는 아닙니다. 여러 설정 파일을 의도적으로 합치는 규칙도 원문 객체의 중복과 별도로 검사해야 합니다.
| 상황 | 확인할 질문 | 먼저 할 일 |
|---|---|---|
| 같은 객체에서 theme 두 번 | 어느 값을 의도했나 | 원문 보존 후 고유 이름으로 정리 |
| 서로 다른 하위 객체의 theme | 각 범위의 의미가 무엇인가 | 범위별 이름·값을 검사 |
| 설정 파일을 순서대로 병합 | 나중 값이 덮는 규칙이 있나 | 최종 적용 상태와 원문을 대조 |
중복 키 검사는 스키마·필수 값·실제 적용 검사와 함께 사용하십시오. 파서가 받아들였다는 사실만으로 설정의 의미까지 맞다고 승인하지 않습니다.
내 자료에서 확인할 순서
- 설정 원문과 현재 프로그램에서 읽힌 값을 별도로 보존합니다. 중복을 확인하기 전에 파싱 결과만으로 원문을 덮어 저장하지 않습니다.
- 문법 검사 외에 객체 이름의 중복을 확인할 수 있는 읽기 방법을 사용합니다. 중첩된 객체의 동일 키는 어느 범위에 있는지도 구분합니다.
- 중복 키의 각 값과 필요한 실제 설정을 대조합니다. 작성자나 관리자의 의도를 확인할 수 없으면 임의로 하나를 선택하지 않습니다.
- 사본에서 객체마다 이름을 고유하게 정리하고 값의 자료형·필수 항목도 필요한 스키마와 비교합니다.
- 실제로 사용하는 파서나 프로그램의 읽기 결과를 확인합니다. 저장된 JSON과 최종 적용 상태가 필요한 값으로 맞는지 봅니다.
- 변경 전후 파일·선택한 값·이유를 기록하고, 다른 설정 파일이 나중에 같은 항목을 덮어쓰는지도 별도로 확인합니다.
잘못 바꾸었거나 확인이 어려울 때
중복을 지웠는데 동작이 달라지면 원래 결과가 어느 값으로 해석되고 있었는지부터 확인해야 합니다. 문법 통과를 의미 검증으로 취급하면 중복뿐 아니라 잘못된 자료형·빠진 필수 값도 놓칠 수 있습니다. 비밀번호나 토큰이 있는 실제 설정은 공개 예제나 불명확한 외부 검사창에 올리지 않습니다.
정상 완료 기준
정상 완료는 필요한 객체 범위에서 이름이 고유하고, 필수 항목과 자료형이 맞으며, 실제 사용하는 도구의 최종 값이 의도와 일치하는 상태입니다. 공개 원문에서는 멤버 두 개와 기본 파싱 결과 한 개의 차이가 확인돼야 합니다. 문법·중복·의미·실제 적용이라는 서로 다른 확인을 기록하십시오.
같은 예제를 다시 확인할 자료
theme라는 가상 키와 두 파서를 비교했습니다. 모든 JSON 파서·설정 병합 체계가 마지막 값을 선택한다고 일반화하지 않습니다. 이 파일은 실제 앱 설정을 바꾸는 예제가 아니며 민감 정보도 없습니다.
- duplicate-key.json (32 bytes)
- unique-key.json (16 bytes)
- json-duplicate-demo.html (1000 bytes)
자료는 비민감 가상 예제입니다. 손상·불일치라고 표시한 파일은 차이를 확인하는 실험용이며 업무 원본으로 사용하지 않습니다. 파일 크기·SHA-256 목록으로 내려받은 원본을 확인할 수 있습니다.
같은 이름에 여러 항목이 있는 다른 사례는 중복 경로 ZIP 실험에서 볼 수 있습니다. ZIP과 JSON의 처리 규칙이 같다는 뜻은 아닙니다.
