본문으로 바로 가기
인생은 여울여울

홈 / 글 모아보기

JSON 객체와 목록 구분: 파이썬으로 맨 바깥 구조 확인하기

JSON을 읽은 뒤 바로 value["title"]처럼 키를 찾기 전에, 맨 바깥 값이 객체인지 목록인지 확인하세요. JSON의 중괄호는 파이썬 dict, 대괄호는 list가 될 수 있습니다. 문법이 잘못된 문자열은 값으로 바뀌지 않고 오류가 납니다. 이 글은 세 연습 문자열을 실제로 실행해 차이를 보여줍니다.

2026년 9월 27일 macOS의 Python 3.14.4에서 아래 코드와 세 출력을 확인했습니다. Python json.loads() 공식 문서는 JSON 문자열을 파이썬 값으로 해석한다고 설명합니다. 같은 문서의 오류 설명은 유효하지 않은 문서에서 JSONDecodeError가 발생한다고 밝힙니다.

JSON 객체 문자열은 dict, 배열 문자열은 list, 닫히지 않은 문자열은 형식 오류가 되는 세 실행 결과
맨 바깥 모양에 따라 처리할 코드가 달라집니다. 그림 없이도 아래 실행 출력으로 세 경우를 확인할 수 있습니다.

세 가지 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 공식 문서도 최상위 비객체·비배열 값을 허용한다고 설명합니다. 세 입력에서 위 세 줄이 각각 나오면 완료입니다. 실제 파일의 경로가 맞는지 먼저 확인해야 한다면 파일 목록 실습부터 진행하세요.

댓글 남기기