Как обеспечить единообразие обработки ошибок и кода на разных слоях приложения — контроллер, сервис, репозиторий?

В многослойных приложениях ошибки возникают на каждом уровне: репозиторий может получить ошибку соединения с БД, сервис — нарушение бизнес-правила, контроллер — некорректный ввод. Если каждый слой обрабатывает ошибки по-своему, код становится непредсказуемым и дублируется. Решение — определить единую иерархию исключений и правило: каждый слой либо обрабатывает ошибку, либо оборачивает её в понятное для вышестоящего слоя исключение.

Иерархия исключений

Создайте базовый класс ошибки приложения и наследников для разных категорий: валидация, доступ, бизнес-логика, инфраструктура. Это позволяет вышестоящим слоям реагировать на тип ошибки, не зная деталей реализации.

class AppError extends Error {
  constructor(message, code, status = 500) {
    super(message);
    this.code = code;
    this.status = status;
  }
}
class NotFoundError extends AppError {
  constructor(msg) { super(msg, 'NOT_FOUND', 404); }
}
class ValidationError extends AppError {
  constructor(msg) { super(msg, 'VALIDATION', 400); }
}

Правила по слоям

• Репозиторий — не знает про HTTP. Ошибки драйвера БД оборачивает в инфраструктурные исключения (например, DatabaseError).
• Сервис — работает с доменными ошибками. Если сущность не найдена, бросает NotFoundError; при нарушении правил — ValidationError.
• Контроллер — не содержит бизнес-логики. Просто вызывает сервис и передаёт результат дальше, а исключения ловит централизованный обработчик.

Централизованный обработчик

В Express это middleware с четырьмя аргументами, в NestJS — ExceptionFilter, в Spring — @ControllerAdvice. Он перехватывает все исключения и формирует единый JSON-ответ.

app.use((err, req, res, next) => {
  const status = err.status || 500;
  res.status(status).json({
    error: {
      code: err.code || 'INTERNAL',
      message: err.message || 'Unexpected error'
    }
  });
});

Единый формат ответа

Помимо ошибок, стоит унифицировать и успешные ответы: одинаковая структура { data, meta } или { error } упрощает работу клиента. Логирование ошибок также лучше делать в одном месте — в обработчике, а не разбрасывать по слоям.

Итог: применяйте такой подход в любом проекте с более чем одним слоем — он убирает дублирование, упрощает тестирование и делает контракт API предсказуемым для клиентов.