Вывод сообщений об ошибках в Python: практическое руководство

Расширенные примеры вывода ошибок с нестандартными подходами и детальными пояснениями.

Пример 1. Использование контекстного менеджера для логирования ошибок

Автоматический перехват и логирование исключений в блоке with.

import logging
from contextlib import contextmanager

logger = logging.getLogger(__name__)
logging.basicConfig(level=logging.ERROR)

@contextmanager
def log_errors(logger, message=""):
    try:
        yield
    except Exception as e:
        logger.exception(message or str(e))

with log_errors(logger, "Ошибка при выполнении операции"):
    result = 1 / 0

ERROR:__main__:Ошибка при выполнении операции
Traceback (most recent call last):
  File "", line 7, in log_errors
  File "", line 14, in 
ZeroDivisionError: division by zero

Пример 2. Запись ошибок с разделением по уровню важности

Настройка нескольких обработчиков: консоль для WARNING и выше, файл для ERROR.

import logging

logger = logging.getLogger("app")
logger.setLevel(logging.DEBUG)

console = logging.StreamHandler()
console.setLevel(logging.WARNING)
file_handler = logging.FileHandler("errors.log")
file_handler.setLevel(logging.ERROR)

formatter = logging.Formatter("%(asctime)s %(levelname)s %(message)s")
console.setFormatter(formatter)
file_handler.setFormatter(formatter)

logger.addHandler(console)
logger.addHandler(file_handler)

try:
    import nonexistent_module
except ImportError:
    logger.warning("Модуль не найден, используется запасной вариант")
    logger.error("Критическая ошибка: невозможно продолжить")

На консоль будет выведено только WARNING, а ERROR попадёт в файл.

Пример 3. Вывод ошибки с цветовой разметкой в Linux терминале

Использование escape-кодов ANSI для подсветки сообщений.

import traceback
import sys

RED = "\033[91m"
RESET = "\033[0m"

try:
    [1,2][5]
except IndexError:
    exc_info = traceback.format_exc()
    sys.stderr.write(f"{RED}{exc_info}{RESET}")

(red text)Traceback (most recent call last):
  File "test.py", line 6, in 
    [1,2][5]
IndexError: list index out of range

Пример 4. Извлечение стека в виде строки для отправки по API

Функция traceback.format_exc возвращает строку, которую можно передать в веб-сервис.

import traceback
import requests

try:
    dangerous_call()
except Exception:
    stack = traceback.format_exc()
    requests.post("https://logging.example.com/errors", json={"stack": stack})

Пример 5. Использование модуля warnings для нефатальных ошибок

Предупреждения не прерывают выполнение, но могут выводиться на stderr.

import warnings

warnings.warn("Устаревший синтаксис, обновите код", DeprecationWarning)

# Вывод:
# test.py:1: DeprecationWarning: Устаревший синтаксис, обновите код

Можно фильтровать по категориям или превращать в исключения (warnings.filterwarnings('error')).

Пример 6. Вывод ошибки с информацией о локальных переменных в момент сбоя

Использование модуля pdb (post-mortem) или traceback.print_exception с явной передачей traceback.

import traceback
import sys

def divide(a, b):
    return a / b

try:
    divide(10, 0)
except ZeroDivisionError:
    # печатаем дополнительную информацию
    etype, value, tb = sys.exc_info()
    traceback.print_exception(etype, value, tb, limit=5, chain=True)
    # limit=5 - количество кадров стека

Пример 7. Подавление вывода ошибок (только для отладки)

Иногда нужно временно скрыть ошибки (например, в тестах). Используйте redirect_stderr в контекстном менеджере.

from contextlib import redirect_stderr
import io

fake_stderr = io.StringIO()
with redirect_stderr(fake_stderr):
    try:
        1 / 0
    except:
        sys.excepthook(*sys.exc_info())
error_text = fake_stderr.getvalue()
print("Захвачено:", error_text)

Пример 8. Создание централизованного обработчика ошибок для веб-фреймворка Flask

Регистрация функций, вызываемых при возникновении необработанных исключений.

from flask import Flask, jsonify
import traceback

app = Flask(__name__)

@app.errorhandler(Exception)
def handle_exception(e):
    response = {
        "error": str(e),
        "traceback": traceback.format_exc()
    }
    return jsonify(response), 500

@app.route('/')
def index():
    raise RuntimeError("Пример ошибки")

if __name__ == '__main__':
    app.run()

При запросе к '/' вернётся JSON с деталями ошибки.