Обработка ошибок в Python: практический пример для сервиса
Разбираем обработку ошибок на Python 3.12 в сценарии пакетной обработки заказов: какие исключения перехватывать, где логировать сбой, когда продолжать работу, а когда останавливать весь процесс.

Пакетная обработка заказов не должна падать из-за одной испорченной записи, но скрывать ошибки тоже опасно: так вы получите отчёт об успехе, хотя часть данных потеряна. Ниже — практический пример для Python 3.12: функция проверяет заказ, отделяет ожидаемые ошибки от программных сбоев, пишет подробный лог и возвращает итог, который можно безопасно показать оператору или передать следующему этапу.
Задача: обработать заказы и не потерять причину сбоя
Представим сервис, который получает список заказов из JSON-файла. У каждого заказа должны быть поля order_id, amount и email. В реальном проекте на этом месте может быть запрос к базе, платёжному шлюзу или внешнему API, но принцип обработки ошибок останется тем же.
Нужно разделить три ситуации:
- данные заказа неверны — запись можно отклонить, а остальные продолжить;
- временная проблема внешней системы — иногда имеет смысл повторить операцию;
- ошибка в коде или неожиданное состояние — его нельзя маскировать, нужно сохранить контекст и остановить текущую обработку.
Исключение1 — объект Python, который сообщает о невозможности продолжить обычный путь выполнения. Обработчик должен не просто «поймать ошибку», а принять решение: исправить её, повторить операцию, передать выше или завершить процесс.
Хорошая обработка ошибок отвечает на два вопроса: можно ли продолжить работу и что именно нужно изменить, чтобы ошибка не повторилась.
Сначала опишите ошибки предметной области
Не стоит использовать один общий класс вроде Exception для всех ожидаемых проблем. Собственные исключения позволяют отделить ошибку входных данных от сбоя инфраструктуры и не привязывать бизнес-логику к тексту сообщения.
class OrderError(Exception):
"""Базовая ошибка обработки заказа."""
class InvalidOrderError(OrderError):
"""Заказ не прошёл проверку входных данных."""
class TemporaryOrderError(OrderError):
"""Операцию можно повторить позже."""
Классы выше не делают обработку автоматически. Они создают понятный контракт между функцией, которая обнаружила проблему, и кодом, который решает, что делать дальше.
Проверяйте входные данные до основной операции
Проверка должна быть отдельной функцией. Так её проще тестировать и нельзя случайно смешать в одном блоке валидацию, запись в базу и формирование ответа.
from decimal import Decimal, InvalidOperation
from typing import Any
def validate_order(order: dict[str, Any]) -> None:
required_fields = ("order_id", "amount", "email")
missing_fields = [
field for field in required_fields
if field not in order
]
if missing_fields:
raise InvalidOrderError(
f"Не хватает полей: {', '.join(missing_fields)}"
)
if not isinstance(order["order_id"], str) or not order["order_id"].strip():
raise InvalidOrderError("order_id должен быть непустой строкой")
try:
amount = Decimal(str(order["amount"]))
except (InvalidOperation, TypeError, ValueError) as error:
raise InvalidOrderError("amount должен быть числом") from error
if amount <= 0:
raise InvalidOrderError("amount должен быть больше нуля")
if "@" not in order["email"]:
raise InvalidOrderError("email не похож на адрес электронной почты")
Здесь используется raise ... from error: наружу уходит понятная ошибка предметной области, но исходная причина не исчезает из цепочки исключений. Это особенно полезно при диагностике ошибок преобразования числа.
Обрабатывайте один заказ в отдельной границе
Следующая функция показывает границу, на которой можно безопасно принять решение. В настоящем сервисе вместо условного кода будет вызов базы данных или внешнего API.
import logging
from typing import Any
logger = logging.getLogger(__name__)
def save_order(order: dict[str, Any]) -> None:
"""Сохраняет заказ. В примере место базы данных обозначено явно."""
if order.get("simulate_temporary_error"):
raise TemporaryOrderError("хранилище временно недоступно")
# Здесь должен находиться реальный вызов репозитория или базы данных.
logger.info("Заказ %s сохранён", order["order_id"])
def process_order(order: dict[str, Any]) -> str:
validate_order(order)
save_order(order)
return "processed"
Важно, что process_order не ловит все исключения подряд. Если в нём есть ошибка программиста, например обращение к несуществующей переменной, она должна остаться видимой и попасть в мониторинг, а не превратиться в обычный отказ заказа.
Соберите ошибки в пакетном обработчике
На верхнем уровне у нас уже есть контекст одной записи: идентификатор заказа. Поэтому здесь можно продолжить цикл после ошибки данных, отдельно отметить временный сбой и пробросить неизвестную ошибку выше.
def process_orders(orders: list[dict[str, Any]]) -> dict[str, list[str]]:
result = {
"processed": [],
"invalid": [],
"temporary_failures": [],
}
for order in orders:
order_id = str(order.get("order_id", "<unknown>"))
try:
process_order(order)
except InvalidOrderError as error:
logger.warning(
"Заказ %s отклонён: %s",
order_id,
error,
)
result["invalid"].append(order_id)
except TemporaryOrderError:
logger.exception(
"Временный сбой при обработке заказа %s",
order_id,
)
result["temporary_failures"].append(order_id)
else:
result["processed"].append(order_id)
return result
Блок else выполняется только при успешном завершении try. Это точнее, чем добавлять заказ в список успешных внутри основного блока до того, как вся операция закончилась.
Почему не стоит писать except Exception
Широкий обработчик допустим на самой внешней границе приложения — например, чтобы записать ошибку и вернуть HTTP 500. Внутри бизнес-логики он опасен: он может скрыть KeyError, ошибку типов или повреждённое состояние, после чего система продолжит работу с неверными данными.
Если внешний обработчик всё же нужен, логируйте исключение вместе со стеком:
def run_batch(orders: list[dict[str, Any]]) -> dict[str, list[str]]:
try:
return process_orders(orders)
except Exception:
logger.exception("Пакетная обработка остановлена из-за неожиданной ошибки")
raise
logger.exception нужно вызывать внутри блока except. Он добавляет traceback — цепочку вызовов, по которой можно понять, где именно произошёл сбой.
Что выбрать для разных классов ошибок
| Ситуация | Что делать | Что записать в лог |
|---|---|---|
| Не хватает поля или неверный формат | Отклонить одну запись и продолжить пакет | Идентификатор заказа и название поля |
| Временная недоступность хранилища | Пометить для повтора или завершить пакет по политике сервиса | Идентификатор, тип сбоя, traceback |
| Неожиданная ошибка в коде | Остановить текущую операцию и передать исключение выше | Полный traceback и технический контекст |
| Ошибка без безопасного текста для пользователя | Вернуть общее сообщение, детали оставить в логе | Подробности без секретов и персональных данных |
Типичные ошибки в обработчиках
Ловить исключение и ничего не делать
try:
process_order(order)
except Exception:
pass
Такой код превращает сбой в ложный успех. Если ошибку нельзя обработать на этом уровне, её лучше передать выше через raise.
Показывать пользователю текст traceback
Traceback полезен разработчику, но может раскрыть пути к файлам, структуру проекта или внутренние данные. Внешний ответ должен быть коротким: например, «заказ временно не обработан». Полная причина должна находиться в защищённом логе.
Повторять любую ошибку
Повтор имеет смысл для временного сбоя, но не исправит невалидный email или отрицательную сумму. Для повторов также нужны ограничение числа попыток, пауза между ними и защита от повторной записи одного заказа.
Логировать пароль, токен или полный запрос
Перед записью контекста удаляйте секреты и минимизируйте персональные данные. Идентификатор заказа обычно полезнее полного объекта с адресом, телефоном и платёжными реквизитами.
Как проверить решение
Для практической проверки достаточно четырёх входных случаев:
- корректный заказ — он должен попасть в
processed; - заказ без
email— он должен попасть вinvalid, а цикл продолжиться; - заказ с флагом
simulate_temporary_error— он должен попасть вtemporary_failures; - искусственная ошибка программиста внутри
save_order— она не должна превратиться в успешную обработку.
Проверяйте не только итоговый список. Зафиксируйте, что в логах есть идентификатор заказа, уровень сообщения и traceback для неожиданного или временного сбоя. В проде также измеряйте долю ошибок каждого класса и возраст очереди повторной обработки.
Что делать дальше
После базовой обработки добавьте автоматические тесты на каждый класс исключений и отдельную политику повторов для временных сбоев. Затем проверьте, как ваш лог-сборщик маскирует секреты и связывает ошибку с идентификатором запроса. Инвалидация повторной операции и идемпотентность записи — отдельная тема, но без неё повтор может создать дубликаты.
1 В Python исключения обычно наследуются от Exception; системные сигналы завершения вроде KeyboardInterrupt имеют другую ветку наследования и не должны автоматически обрабатываться как обычная ошибка приложения.
Разрушитель авто-разводов: Фото заказ-наряда СТО: завышения, дубли работ, лишние позиции.
Спросить за 15 ₽Источники: Python 3.12 Documentation: Errors and Exceptions, Python 3.12 Documentation: Logging HOWTO
Частые вопросы
Нужно ли всегда писать try/except вокруг каждой функции?
Почему нельзя просто использовать except Exception?
Как понять, что ошибку можно повторить?
Что делать, если после обработки ошибки процесс всё равно падает?
Можно ли показывать пользователю текст исключения?
Изменится ли этот пример в другой версии Python?
Материал носит информационный характер и подготовлен редакцией «Агентуры». Он не является офертой, рекламой или индивидуальной консультацией. Упомянутые продукты, компании и торговые знаки принадлежат их правообладателям. Перед принятием решений, влекущих юридические или финансовые последствия, обратитесь к профильному специалисту.