Как использовать трассировку стека в Python (модуль traceback)

Расширенные примеры работы с traceback

В этом разделе приведены более сложные сценарии использования модуля traceback, которые часто встречаются на практике.

Кастомное форматирование с TracebackException

Класс traceback.TracebackException позволяет детально управлять форматированием: исключать контекст, ограничивать глубину, изменять представление стека.

import traceback, sys

try:
    1 / 0
except ZeroDivisionError:
    exc_type, exc_value, exc_tb = sys.exc_info()
    tbe = traceback.TracebackException(exc_type, exc_value, exc_tb, limit=2)
    # Пропускаем первую строку 'Traceback...'
    formatted = list(tbe.format())[1:]  # список строк без заголовка
    for line in formatted:
        print(line, end='')

  File "<stdin>", line 3, in <module>
ZeroDivisionError: division by zero

Цепочка исключений с явным указанием причины

При перехвате одного исключения и возбуждении другого с сохранением контекста (использование raise ... from) модуль traceback показывает обе трассировки.

import traceback

def read_data(filepath):
    try:
        with open(filepath) as f:
            return f.read()
    except FileNotFoundError as e:
        raise ValueError(f'Файл {filepath} не найден') from e

try:
    read_data('/nonexistent')
except ValueError:
    traceback.print_exc()

Traceback (most recent call last):
  File "<stdin>", line 6, in read_data
    with open(filepath) as f:
FileNotFoundError: [Errno 2] No such file or directory: '/nonexistent'

The above exception was the direct cause of the following exception:

Traceback (most recent call last):
  File "<stdin>", line 14, in <module>
    read_data('/nonexistent')
  File "<stdin>", line 8, in read_data
    raise ValueError(f'Файл {filepath} не найден') from e
ValueError: Файл /nonexistent не найден

Извлечение стека из нескольких потоков

Для получения стека вызовов другого потока используется traceback.format_stack(sys._current_frames()[thread_id]). Это полезно при анализе взаимоблокировок.

import sys, threading, traceback

def worker():
    import time
    time.sleep(10)

t = threading.Thread(target=worker)
t.start()
import time
time.sleep(0.1)  # даём потоку запуститься
# Получаем стек потока t
frames = sys._current_frames()
if t.ident in frames:
    stack = traceback.format_stack(frames[t.ident])
    print(''.join(stack))

  File "<stdin>", line 8, in worker
    import time
  File "<stdin>", line 9, in worker
    time.sleep(10)

Ручное построение traceback из объектов фреймов

Иногда требуется создать собственный traceback, например, для эмуляции исключения при тестировании. Можно использовать traceback.FrameSummary и traceback.StackSummary.

import traceback

# Создаём один фрейм вручную
frame_summary = traceback.FrameSummary('myscript.py', 42, 'calculate')
stack = traceback.StackSummary.from_list([frame_summary])
# Форматируем как строку
result = stack.format()
print(''.join(result))

  File "myscript.py", line 42, in calculate

Логирование traceback с кастомным форматтером

Можно настроить обработчик логов так, чтобы он добавлял traceback только определённого уровня, используя exc_info в сообщении.

import logging, traceback

logger = logging.getLogger('app')
handler = logging.StreamHandler()
formatter = logging.Formatter('%(asctime)s - %(levelname)s - %(message)s')
handler.setFormatter(formatter)
logger.addHandler(handler)
logger.setLevel(logging.WARNING)

try:
    1/0
except ZeroDivisionError:
    # exc_info=True добавит traceback к сообщению
    logger.warning('Обнаружено деление на ноль', exc_info=True)

2025-03-21 12:00:00,000 - WARNING - Обнаружено деление на ноль
Traceback (most recent call last):
  File "<stdin>", line 11, in <module>
    1/0
ZeroDivisionError: division by zero