Python: TypeError 'NoneType object is not subscriptable' — как исправить ошибку

[kirilljsx]

Ошибка TypeError: ‘NoneType’ object is not subscriptable — одна из самых частых в Python. Она возникает, когда код пытается обратиться к элементу объекта, который на самом деле равен None. Это ломает работу с базами данных, API и функциями, возвращающими пустой результат.

Понимание причины поможет быстро находить и фиксить такие баги. В этой статье разберём, почему None не поддерживает индексацию, покажем реальные примеры и способы исправления. Вы научитесь проверять данные перед использованием и избегать подобных ошибок в проектах.

Почему возникает ошибка ‘NoneType object is not subscriptable’

NoneType — это специальный тип в Python, который представляет отсутствие значения. Объект None не имеет методов __getitem__, поэтому попытка none_object или none_object['key'] вызывает TypeError. Ошибка сигнализирует: вы ожидаете список, словарь или строку, а получили None.

Типичные сценарии — запросы к MongoDB, SQLite, API через requests или функции, которые не нашли данные. Метод find_one() в PyMongo возвращает None, если документ не существует. Аналогично fetchone() в sqlite3 или get() в JSON-ответах. Без проверки код падает на строке с квадратными скобками.

Примеры возникновения ошибки

Вот классический кейс с базой данных:

def home(request):
    client = pymongo.MongoClient(settings.MONGO_SERVER)
    main_db = client[settings.MONGO_DATABASE]
    get_main_config = main_db.configurations.find_one({"name": "main_config"})
    return render(request, 'dashboard/home.html', {"data": get_main_config["homepage_urls"]})

Здесь find_one() вернул None, и get_main_config["homepage_urls"] вызывает ошибку. То же самое с requests.get().json() — если API не нашёл данные, response['data'] упадёт.

• Базы данных: cursor.fetchone() возвращает None при отсутствии записи.
• API-запросы: res.json().get('data')['list'] ломается, если ключ отсутствует.
• Функции: get_user(123) возвращает None, но код пытается user['name'].

Основные способы исправления ошибки

Первый шаг — всегда проверяйте объект на None перед индексацией. Используйте if obj is not None или оператор or. Это базовое правило для стабильного кода. Дополнительно логируйте значения переменных: print(f'{obj=}', type(obj)) поможет отладить.

Второй подход — используйте безопасные методы: .get() для словарей с значением по умолчанию, or {} для пустых структур. Для списков подойдёт obj if obj else None. Эти приёмы предотвращают краш и делают код чище.

Шаги по исправлению

1. Проверьте тип переменной: print(type(get_main_config)) покажет NoneType.
2. Добавьте условие: if get_main_config: data = get_main_config.get('homepage_urls', []).
3. Обработайте None: Верните дефолтное значение или пустой шаблон.
4. Протестируйте отсутствие данных: Создайте сценарий без записи в БД.

Сравнение методов проверки на None

Метод	Пример кода	Преимущества	Недостатки
if obj is not None	if user: print(user['name'])	Явная проверка, читаемо	Требует if-блока
obj or default	data = config or {}	Коротко, inline	Не работает с falsy-значениями (0, ‘’)
.get() с default	config.get('key', [])	Безопасно для словарей	Только для dict
try-except	try: data = obj except TypeError: data = []	Ловит все ошибки	Маскирует другие проблемы

Выбирайте if obj: для большинства случаев — это стандарт Python. Помните: if obj: проверяет не только None, но и пустые коллекции.

Правильные примеры фиксов

# Плохо
get_main_config = main_db.configurations.find_one({"name": "main_config"})
data = get_main_config["homepage_urls"]

# Хорошо
get_main_config = main_db.configurations.find_one({"name": "main_config"})
if get_main_config:
    data = get_main_config.get("homepage_urls", [])
else:
    data = []

Для SQLite:

result = cursor.execute('SELECT cash FROM users WHERE id = ?', (user_id,)).fetchone()
cash = result if result else 0

Лучшие практики предотвращения ошибки

Пишите функции, которые гарантируют тип возвращаемого значения. Вместо return find_one() возвращайте find_one() or {}. Используйте type hints: def get_config() -> dict | None. Это поможет IDE и mypy ловить баги на этапе разработки.

Интегрируйте логирование: logger.warning(f'Config not found: {query}'). Тестируйте edge-кейсы — отсутствие данных, сетевые сбои. Для API добавляйте response.raise_for_status() перед парсингом JSON.

• Type hints: data: list[str] | None = None.
• Дефолты: Всегда указывайте get(key, default).
• Валидация: assert isinstance(obj, dict), f'Expected dict, got {type(obj)}' в тестах.

В продакшене избегайте print() — используйте logging модуль.

Когда None — это не проблема, а фича

Иногда None полезен для сигнала ‘не найдено’. Главное — обрабатывайте его предсказуемо. Подумайте о Optional-типах из typing и union-типах в новых версиях Python. Стоит поэкспериментировать с match-выражениями в 3.10+ для элегантной обработки None и других случаев.

Разные библиотеки по-разному возвращают отсутствие данных: Pandas — NaN, SQLAlchemy — None. Изучите документацию PyMongo, sqlite3 и requests для нюансов. Это сэкономит часы дебага в сложных проектах.