JSON을 읽은 뒤 바로 value["title"]처럼 키를 찾기 전에, 맨 바깥 값이 객체인지 목록인지 확인하세요. JSON의 중괄호는 파이썬 dict, 대괄호는 list가 될 수 있습니다. 문법이 잘못된 문자열은 값으로 바뀌지 않고 오류가 납니다. 이 글은 세 연습 문자열을 실제로 실행해 차이를 보여줍니다.
2026년 9월 27일 macOS의 Python 3.14.4에서 아래 코드와 세 출력을 확인했습니다. Python json.loads() 공식 문서는 JSON 문자열을 파이썬 값으로 해석한다고 설명합니다. 같은 문서의 오류 설명은 유효하지 않은 문서에서 JSONDecodeError가 발생한다고 밝힙니다.

세 가지 JSON 문자열을 검사하세요
다음 코드를 check_json_shape.py로 저장하고 python3 check_json_shape.py를 실행하세요. Windows에서 해당 명령이 없다면 설치된 Python의 py를 사용할 수 있습니다. 실제 다운로드 파일이나 웹 응답 대신 짧은 연습 문자열을 사용해 다른 데이터를 읽거나 변경하지 않습니다.
import json
samples = (
("객체", '{"title": "여울", "done": false}'),
("목록", '[{"title": "여울"}]'),
("오류", '{"title":'),
)
for label, text in samples:
try:
value = json.loads(text)
except json.JSONDecodeError:
print(f"{label}: JSON 형식을 다시 확인하세요")
continue
if isinstance(value, dict):
print(f"{label}: 객체, 키={list(value)}")
elif isinstance(value, list):
print(f"{label}: 목록, 항목 수={len(value)}")
else:
print(f"{label}: 다른 최상위 값, 종류={type(value).__name__}")
첫 입력의 false는 JSON 표기입니다. 파이썬 코드 안의 큰따옴표로 둘러싸인 JSON 문자열 속에 있으므로 json.loads()가 해석합니다. 두 번째는 객체 하나를 담은 목록입니다. 둘 다 유효한 JSON이지만 값을 꺼내는 방법은 다릅니다.
실제 출력과 처리 분기를 비교하세요
객체: 객체, 키=['title', 'done']
목록: 목록, 항목 수=1
오류: JSON 형식을 다시 확인하세요
객체라면 dict의 키를, 목록이라면 list의 항목 수를 먼저 볼 수 있습니다. 세 번째 입력은 {"title":에서 값과 닫는 중괄호가 없으므로 JSONDecodeError를 잡아 별도 안내를 출력합니다. 목록을 객체로 오인해 value["title"]을 시도하는 대신, 종류를 확인한 후 해당 구조에 맞는 접근을 선택하세요.
자신의 JSON에 옮겨 쓰기 전에 확인하세요
자신의 데이터를 시험할 때는 먼저 사본을 만들고, 이 코드의 연습 문자열 하나를 사본 내용으로 바꿔 보세요. 이 예시는 문자열을 해석할 뿐 파일을 읽거나 저장하지 않습니다. 실제 파일을 읽는 단계에는 인코딩·파일 경로 오류가 추가되므로 이 실습 결과만으로 그 부분까지 검증했다고 보지 마세요.
또한 JSON의 최상위 값은 객체나 목록 외에 문자열·숫자·불리언·null일 수도 있습니다. 그래서 마지막 else 분기를 두었습니다. Python 공식 문서도 최상위 비객체·비배열 값을 허용한다고 설명합니다. 세 입력에서 위 세 줄이 각각 나오면 완료입니다. 실제 파일의 경로가 맞는지 먼저 확인해야 한다면 파일 목록 실습부터 진행하세요.