Python "TypeError: 'NoneType' object cannot be subscripted" 오류 해결법

Python에서 발생하는 "TypeError: 'NoneType' object cannot be subscripted" 오류는 변수나 객체가 `None`일 때 발생합니다. `None`은 Python에서 '값 없음'을 나타내는 특별한 객체로, `None` 객체는 인덱싱이나 슬라이싱을 할 수 없습니다. 이 오류는 흔히 함수나 변수의 결과가 `None`인 경우 발생하며, 이를 해결하려면 `None` 객체를 올바르게 처리해야 합니다. 이 글에서는 이 오류의 원인과 해결 방법을 상세히 설명합니다.

1. 'TypeError: 'NoneType' object cannot be subscripted' 오류 원인

이 오류는 `None` 객체에 대해 인덱싱(`[]`) 또는 슬라이싱(`[:]`)을 시도할 때 발생합니다. `None`은 반복 가능한 객체나 컬렉션이 아니므로, `None`에 대해 인덱싱을 시도하면 이 오류가 발생합니다. 예를 들어, 리스트나 튜플에서 값을 가져오려 할 때 그 값이 `None`일 경우 이 오류가 발생합니다.

주로 다음과 같은 상황에서 이 오류가 발생합니다:

함수에서 값이 반환되지 않음: 함수가 `None`을 반환하고, 그 반환값에 대해 인덱싱이나 슬라이싱을 시도할 때 발생합니다.
객체나 변수에 예상치 못하게 `None`이 할당된 경우: 변수나 객체가 `None`으로 초기화되었거나, 예상과 달리 `None`이 할당된 경우에 오류가 발생할 수 있습니다.
리스트나 딕셔너리에서 `None`이 포함된 경우: 리스트나 딕셔너리의 값이 `None`일 때 그 값을 인덱싱하려고 할 때 오류가 발생합니다.

2. 'TypeError: 'NoneType' object cannot be subscripted' 오류 해결 방법

이 오류를 해결하려면 `None` 객체를 인덱싱하려는 시도를 방지하거나, `None`이 할당될 수 있는 상황을 처리해야 합니다. 아래에서는 이 오류를 해결할 수 있는 방법을 설명합니다.

2.1 함수 반환값 확인하기

가장 일반적인 원인은 함수가 `None`을 반환할 때 발생합니다. 함수가 반환값을 제대로 반환하는지 확인하고, 그 반환값이 `None`인지 체크하는 것이 중요합니다. 예를 들어:


# 잘못된 코드: 함수가 None을 반환한 후 인덱싱 시도
def get_value():
    return None

value = get_value()
print(value[0])  # "TypeError: 'NoneType' object cannot be subscripted" 오류 발생

# 올바른 코드: 반환값이 None인지 체크
def get_value():
    return None

value = get_value()
if value is not None:
    print(value[0])
else:
    print("값이 None입니다.")

위 코드에서 `get_value()` 함수가 `None`을 반환하고, 그 결과에 대해 인덱싱을 시도하면 오류가 발생합니다. 이를 해결하려면 `None`을 반환할 수 있는 함수의 반환값을 확인하거나 조건문으로 처리할 수 있습니다.

2.2 `None` 타입 체크하기

변수나 객체가 `None`인지 확인하고, 그 후에 인덱싱을 시도하는 것이 좋습니다. 이를 위해 `if` 조건문을 사용하여 `None`을 처리할 수 있습니다:


data = None

if data is not None:
    print(data[0])  # data가 None이 아니면 인덱싱
else:
    print("data는 None입니다.")  # data가 None일 경우 처리

위 코드는 `data`가 `None`이 아니면 인덱싱을 하고, 그렇지 않으면 적절한 메시지를 출력하는 방식으로 오류를 방지합니다.

2.3 함수에서 반환값 처리하기

함수에서 `None`을 반환할 경우, 반환값이 `None`일 때 발생할 수 있는 오류를 사전에 처리하는 방법을 고려할 수 있습니다. 함수가 `None`을 반환하지 않도록 기본값을 설정하거나 예외 처리를 할 수 있습니다. 예를 들어:


# 잘못된 코드: 함수가 None을 반환함
def get_data():
    return None

result = get_data()
print(result[0])  # "TypeError: 'NoneType' object cannot be subscripted" 오류 발생

# 올바른 코드: 반환값이 None인 경우 예외 처리
def get_data():
    return None

result = get_data()
if result:
    print(result[0])
else:
    print("데이터가 없습니다.")

이와 같이 `None`을 반환할 수 있는 함수를 호출한 후 `None` 체크를 하면 오류를 방지할 수 있습니다.

2.4 `None`을 처리하는 예외 처리 방식

만약 `None` 값에 대해 예외 처리를 하고 싶다면, `try-except` 블록을 사용하여 오류를 처리할 수도 있습니다. 예를 들어:


data = None

try:
    print(data[0])  # "TypeError: 'NoneType' object cannot be subscripted"
except TypeError:
    print("데이터가 None입니다. 인덱싱을 할 수 없습니다.")

위 예시에서는 `data`가 `None`일 경우 `TypeError`가 발생하고, 그 오류를 `except` 블록에서 처리하여 사용자에게 적절한 메시지를 제공하는 방식입니다.

3. 결론

"TypeError: 'NoneType' object cannot be subscripted" 오류는 `None` 객체에 대해 인덱싱을 시도할 때 발생합니다. 이를 해결하려면 `None`을 처리하는 방법을 제대로 구현해야 합니다. 함수에서 반환값이 `None`일 수 있음을 고려하고, 그 반환값을 확인한 후 인덱싱을 시도해야 합니다. 또한, `None` 값을 안전하게 처리하려면 조건문이나 예외 처리 방법을 사용하여 오류를 방지할 수 있습니다.

smartmove 님의 블로그

Python "TypeError: 'NoneType' object cannot be subscripted" 오류 해결법