Как читать Traceback в Python: находить строку и причину ошибки

Чтобы понять Traceback, начните с последней строки: там указан тип исключения и причина. Затем поднимитесь к ближайшей строке с вашим файлом и номером строки. Сам Traceback не является отдельной ошибкой. Это маршрут вызовов, по которому Python дошёл до сбоя. Если читать его в правильном порядке, длинное сообщение превращается в несколько конкретных подсказок.

Новичок часто видит десять строк красного текста и начинает исправлять первую. Обычно полезная точка находится внизу. Последняя строка отвечает на вопрос «что случилось», строка над ней показывает «где проявилось», а более ранние кадры объясняют «как программа туда пришла».

Из чего состоит Traceback в Python

def price_per_item(total, count):
    return total / count

print(price_per_item(900, 0))

# Traceback (most recent call last):
#   File "shop.py", line 4, in <module>
#     print(price_per_item(900, 0))
#           ^^^^^^^^^^^^^^^^^^^^^^
#   File "shop.py", line 2, in price_per_item
#     return total / count
#            ~~~~~~^~~~~~~
# ZeroDivisionError: division by zero

У сообщения три уровня: причина внизу, место над ней и путь вызовов выше.

Как читать Traceback снизу вверх

Например, сообщение TypeError: can only concatenate str (not "int") to str уже содержит конфликт типов. Найдите в проблемной строке оператор +, затем проверьте значения через print(type(value), repr(value)). Функция repr покажет кавычки, пробелы и управляющие символы, которые обычный вывод скрывает.

age = input('Сколько вам лет? ')
print(type(age), repr(age))

# Результат при вводе 16:
# <class 'str'> '16'

next_age = int(age) + 1
print(next_age)
# 17

Не угадывайте исправление по названию ошибки: сначала свяжите сообщение с реальными значениями в проблемной строке.

Что означают несколько файлов и функций в стеке

Каждый блок File ... line ... in ... называется кадром стека. Первый кадр показывает ранний вызов, последний находится ближе всего к исключению. Длинный стек не означает много ошибок: одна проблема могла пройти через пять функций и проявиться в шестой.

def parse_count(raw):
    return int(raw)

def make_order(raw_count):
    count = parse_count(raw_count)
    return {'count': count}

print(make_order('три'))

# Последние строки Traceback:
#   File "orders.py", line 5, in make_order
#     count = parse_count(raw_count)
#   File "orders.py", line 2, in parse_count
#     return int(raw)
# ValueError: invalid literal for int() with base 10: 'три'

Идите от последнего кадра к вызывающему, пока не найдёте место, где неверное значение появилось или не было проверено.

Две ошибки подряд и цепочка исключений

Иногда консоль показывает два Traceback, разделённых фразой During handling of the above exception или The above exception was the direct cause. Это цепочка: код перехватил первое исключение, а затем возникло или было явно создано второе. Активной проблемой считается последняя нижняя ошибка, но верхняя объясняет её первопричину.

def read_limit(raw):
    try:
        return int(raw)
    except ValueError as error:
        raise ValueError('Лимит должен быть целым числом') from error

read_limit('десять')

# Сначала Python покажет ValueError от int('десять'),
# затем фразу про direct cause,
# затем ValueError: Лимит должен быть целым числом

Чек-лист: что приложить к вопросу об ошибке

Скриншот одной последней строки редко помогает. Тому, кто разбирает ошибку, нужен весь Traceback, небольшой воспроизводимый код, команда запуска и входные данные. Секреты, токены, адреса закрытых сервисов и личные пути перед отправкой удалите.