Тип traceback в Python: структура, получение и применение

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

1. Анализ цепочки исключений с помощью TracebackException

Когда исключение является следствием другого, Python связывает их через атрибуты __context__ (неявная связь) и __cause__ (явная связь через from). TracebackException предоставляет доступ к этим связям.

import traceback

try:
    try:
        raise RuntimeError("Внутренняя ошибка")
    except RuntimeError as inner:
        raise ValueError("Внешняя ошибка") from inner
except ValueError as outer:
    te = traceback.TracebackException(type(outer), outer, outer.__traceback__)
    # вывод через format
    print(''.join(te.format()))
    # также можно обратиться к причине
    if te.__cause__:
        print("Причина:", te.__cause__)

Traceback (most recent call last):
  File "<stdin>", line 4, in <module>
RuntimeError: Внутренняя ошибка

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

Traceback (most recent call last):
  File "<stdin>", line 6, in <module>
ValueError: Внешняя ошибка
Причина: RuntimeError('Внутренняя ошибка')

2. Получение текущего стека (без исключения) с помощью extract_stack

Функция traceback.extract_stack() возвращает список фреймов текущего стека вызовов. Это полезно для профилирования или логирования состояния программы.

import traceback

def first():
    second()

def second():
    stack = traceback.extract_stack()
    for frame in stack:
        print(f"{frame.filename}:{frame.lineno} in {frame.name}")

first()

/path/to/script.py:8 in second
/path/to/script.py:5 in first
/path/to/script.py:12 in <module>

Обратите внимание: порядок следования фреймов обратный (от текущего к вызывающему).

3. Сохранение traceback в JSON для дальнейшего анализа

Иногда требуется передать информацию об ошибке через сеть или сохранить в структурированном виде. Ниже приведён пример извлечения ключевых данных с помощью extract_tb и сериализации.

import traceback, json, sys

try:
    1 / 0
except ZeroDivisionError as e:
    exc_type, exc_value, exc_tb = sys.exc_info()
    frames = traceback.extract_tb(exc_tb)
    error_info = {
        "type": exc_type.__name__,
        "message": str(exc_value),
        "traceback": [
            {
                "file": frame.filename,
                "line": frame.lineno,
                "function": frame.name,
                "code": frame.line
            }
            for frame in frames
        ]
    }
    print(json.dumps(error_info, indent=2, ensure_ascii=False))

{
  "type": "ZeroDivisionError",
  "message": "division by zero",
  "traceback": [
    {
      "file": "<stdin>",
      "line": 2,
      "function": "<module>",
      "code": "1 / 0"
    }
  ]
}

4. Получение traceback из другого потока

Если исключение возникло в фоновом потоке, его traceback можно получить внутри самого потока, а затем передать в основной поток через очередь. В примере используется format_exc() в потоковой функции.

import threading, traceback, queue

def worker(q):
    try:
        result = 1 / 0
    except Exception:
        tb_str = traceback.format_exc()
        q.put(tb_str)

q = queue.Queue()
t = threading.Thread(target=worker, args=(q,))
t.start()
t.join()
error = q.get()
print("Ошибка из потока:")
print(error)

Ошибка из потока:
Traceback (most recent call last):
  File "<stdin>", line 3, in worker
ZeroDivisionError: division by zero