Печать отчета об ошибке (traceback) в коде Python

Продвинутые примеры работы с traceback

Настройка sys.excepthook с добавлением временной метки

В примере показано, как создать собственный обработчик необработанных исключений, который записывает ошибку в файл с указанием времени.

import sys
import traceback
from datetime import datetime

def custom_hook(exc_type, exc_value, exc_tb):
    timestamp = datetime.now().isoformat()
    with open('errors.log', 'a', encoding='utf-8') as f:
        f.write(f'\n[{timestamp}] {exc_type.__name__}: {exc_value}\n')
        traceback.print_exception(exc_type, exc_value, exc_tb, file=f)
    traceback.print_exception(exc_type, exc_value, exc_tb)

sys.excepthook = custom_hook

raise RuntimeError('Тестовая ошибка')

Traceback (most recent call last):
  File "test.py", line 15, in <module>
    raise RuntimeError('Тестовая ошибка')
RuntimeError: Тестовая ошибка

# В файл errors.log также добавлена запись с временной меткой

Пояснение: обработчик вызывается для всех исключений, которые не перехвачены try-except. Полезно для продакшен-приложений.

Форматирование цепочки исключений с помощью traceback.format_exception

При использовании конструкции raise ... from ... Python сохраняет цепочку исключений. Для её вывода используется traceback.format_exception() с параметром chain=True.

import traceback
import sys

try:
    try:
        1 / 0
    except ZeroDivisionError as e:
        raise ValueError('Ошибка обработки') from e
except ValueError:
    exc_type, exc_value, exc_tb = sys.exc_info()
    formatted = traceback.format_exception(exc_type, exc_value, exc_tb)
    print(''.join(formatted))

Traceback (most recent call last):
  File "test.py", line 5, in <module>
    1 / 0
ZeroDivisionError: division by zero

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

Traceback (most recent call last):
  File "test.py", line 7, in <module>
    raise ValueError('Ошибка обработки') from e
ValueError: Ошибка обработки

Пояснение: Полный traceback включает первичное исключение и вторичное, что помогает диагностировать цепочку причин.

Извлечение и фильтрация кадров с помощью StackSummary.extract

Метод StackSummary.extract() позволяет получить суммарную информацию о стеке с возможностью исключения определённых кадров. Ниже пример фильтрации кадров, содержащих слово 'unittest'.

import traceback
import sys

def inner():
    1 / 0

def outer():
    inner()

try:
    outer()
except:
    exc_type, exc_value, exc_tb = sys.exc_info()
    summary = traceback.StackSummary.extract(traceback.walk_tb(exc_tb))
    filtered = [frame for frame in summary if 'unittest' not in frame.filename]
    for frame in filtered:
        print(f'{frame.filename}:{frame.lineno} in {frame.name}')
        print(f'   {frame.line}')

test.py:21 in outer
    inner()
test.py:17 in inner
    1 / 0

Пояснение: walk_tb создаёт итератор по кадрам, StackSummary.extract собирает из них объекты FrameSummary. Фильтрация помогает убрать шум из системных библиотек.

Запись traceback с использованием модуля logging и ротации файлов

В реальных приложениях часто используют logging с настройкой RotatingFileHandler. Пример конфигурации и логирования исключения.

import logging
from logging.handlers import RotatingFileHandler

handler = RotatingFileHandler('app.log', maxBytes=1024, backupCount=3)
formatter = logging.Formatter('%(asctime)s - %(levelname)s - %(message)s')
handler.setFormatter(formatter)

logger = logging.getLogger(__name__)
logger.addHandler(handler)
logger.setLevel(logging.ERROR)

try:
    x = 1 / 0
except ZeroDivisionError:
    logger.exception('Ошибка деления на ноль')

2025-03-15 10:35:00,000 - ERROR - Ошибка деления на ноль
Traceback (most recent call last):
  File "test.py", line 15, in <module>
    x = 1 / 0
ZeroDivisionError: division by zero

Пояснение: Логирование удобно для продакшена, так как не засоряет консоль и позволяет хранить историю ошибок.