본문 바로가기
카테고리 없음

파이썬 json.decoder.JSONDecodeError 해결법과 디버깅 팁

by vibespace 2025. 4. 18.

파이썬 JSONDecodeError란?

파이썬에서 JSONDecodeError는 JSON 형식을 읽을 때 발생하는 오류입니다. 주로 JSON 파일을 로드하거나 문자열을 JSON 형식으로 변환할 때 발생할 수 있습니다. 이 오류는 대개 JSON 데이터가 올바르게 형식화되지 않았을 때 발생합니다.

JSONDecodeError 예제

다음은 JSONDecodeError가 발생하는 예시입니다. 올바르지 않은 형식의 JSON 파일을 읽으려 할 때 오류가 발생합니다. 


import json

# 잘못된 JSON 형식 (따옴표가 없거나 쉼표가 누락됨)
json_string = '{"name": "John", "age": 30, "city": "New York"'

try:
    data = json.loads(json_string)
except json.JSONDecodeError as e:
    print(f"JSONDecodeError 발생: {e}")

이 예제에서는 JSON 문자열에 닫는 중괄호 '}'가 없어서 JSONDecodeError가 발생합니다.

JSONDecodeError 발생 원인

JSONDecodeError가 발생하는 이유는 여러 가지가 있습니다. 그 중 대표적인 원인들은 다음과 같습니다:

  • 잘못된 구문: 중괄호나 대괄호가 닫히지 않거나 불필요한 쉼표가 있을 때
  • 잘못된 따옴표: JSON에서는 문자열을 반드시 "로 감싸야 하는데, '로 감쌀 경우 오류가 발생할 수 있습니다.
  • 잘못된 이스케이프 문자: 문자열 내에서 이스케이프 문자가 올바르지 않으면 오류가 발생합니다.
  • 부적합한 인코딩: 파일이 UTF-8 외의 인코딩으로 저장되었을 경우

JSONDecodeError 해결법 1: JSON 구문 오류 수정하기

가장 흔한 해결책은 JSON 문자열이 올바르게 형식화되었는지 확인하는 것입니다. 예를 들어, 따옴표나 괄호의 짝이 맞지 않거나 쉼표가 빠졌을 경우 오류가 발생합니다. 


# 올바른 JSON 형식
json_string = '{"name": "John", "age": 30, "city": "New York"}'

# JSON 디코딩
data = json.loads(json_string)
print(data)  # {'name': 'John', 'age': 30, 'city': 'New York'}

위 코드는 JSON 형식이 올바르기 때문에 문제없이 데이터를 파싱할 수 있습니다.

JSONDecodeError 해결법 2: JSON 데이터에 잘못된 따옴표 사용

JSON에서는 문자열을 반드시 " (double quotes)로 감싸야 합니다. ' (single quotes)를 사용할 경우 오류가 발생합니다. 


# 잘못된 따옴표 사용
json_string = "{'name': 'John', 'age': 30, 'city': 'New York'}"  # 오류 발생

# 올바른 따옴표 사용
json_string = '{"name": "John", "age": 30, "city": "New York"}'  # ✅

해결법: 문자열을 쌍따옴표로 감싸세요.

JSONDecodeError 해결법 3: 잘못된 이스케이프 문자 처리

문자열 내에서 이스케이프 문자를 잘못 사용할 경우에도 오류가 발생할 수 있습니다. 예를 들어, 역슬래시(\) 뒤에 다른 특수문자가 제대로 이스케이프되지 않은 경우입니다. 


# 잘못된 이스케이프 문자
json_string = '{"name": "John\\age", "city": "New York"}'  # 오류 발생

# 올바른 이스케이프 처리
json_string = '{"name": "John\\\\age", "city": "New York"}'  # ✅

해결법: 필요한 경우 역슬래시를 두 번 사용하거나 이스케이프 문법을 확인하세요.

JSONDecodeError 해결법 4: 파일 인코딩 문제

만약 JSON 파일을 읽을 때 오류가 발생한다면, 파일 인코딩 문제일 수 있습니다. 기본적으로 UTF-8로 저장된 파일을 읽어야 하며, 다른 인코딩 방식으로 저장된 경우 문제가 발생할 수 있습니다. 


# UTF-8로 인코딩된 파일을 읽어들일 때
with open('data.json', 'r', encoding='utf-8') as f:
    data = json.load(f)
    print(data)

해결법: 파일을 열 때 encoding='utf-8'을 명시적으로 설정하세요.

JSONDecodeError 디버깅 팁

디버깅을 통해 오류를 빠르게 해결할 수 있는 몇 가지 방법은 다음과 같습니다:

  • 오류 메시지 분석: JSONDecodeError는 오류 메시지에 오류 위치와 원인에 대한 힌트를 제공합니다. 예를 들어, "Expecting property name enclosed in double quotes"라는 메시지는 따옴표 문제를 알려줍니다.
  • 온라인 JSON 검사기 사용: JSON 형식 오류를 빠르게 찾아주는 온라인 JSON 포맷 검사기를 사용해 보세요. 이 도구는 오류를 빠르게 추적하는 데 유용합니다.
  • 파일 인코딩 점검: UTF-8이 아닌 인코딩을 사용할 경우, 파일을 열 때 인코딩을 명시적으로 설정합니다.
  • Python 디버거 사용: pdb나 print()로 파싱 중인 JSON 데이터를 출력하여 오류가 발생한 지점을 추적합니다.

정리: JSONDecodeError 해결 방법

JSONDecodeError는 JSON 데이터를 파싱하는 과정에서 발생하는 일반적인 오류입니다. 이 오류는 대개 JSON 데이터 형식이 잘못되었을 때 발생하며, 다음과 같은 점을 확인하여 해결할 수 있습니다:

  • 따옴표, 괄호, 쉼표 등의 구문 오류 수정
  • 이중 따옴표 사용
  • 이스케이프 문자 처리
  • 파일 인코딩 확인

디버깅 과정에서 오류 메시지를 잘 분석하고, JSON 검사기를 활용하면 문제를 쉽게 해결할 수 있습니다. JSON 데이터 형식이 정확한지 항상 점검하고, 오류 발생 시 꼼꼼하게 원인을 찾아 수정하세요.

티스토리툴바