Исключения Django

Django вызывает несколько собственных исключений на ряду со стандартными исключениями Python.

Основные исключения Django

Основные исключения Django определены в django.core.exceptions.

AppRegistryNotReady

exception AppRegistryNotReady

Это исключение будет вызвано при попытке использовать модели до загрузки приложений, которая инициализирует ORM.

ObjectDoesNotExist

exception ObjectDoesNotExist

Основной класс DoesNotExist. try/except для ObjectDoesNotExist словит исключения DoesNotExist для всех моделей.

Смотрите get() для подробной информации об исключениях ObjectDoesNotExist и DoesNotExist.

EmptyResultSet

exception EmptyResultSet

EmptyResultSet может быть вызван при выполнении запроса, если запрос ничего не вернул. Большинство проектов Django не встретят это исключение, но оно может быть полезно для реализации собственных выражений и условий поиска.

FieldDoesNotExist

exception FieldDoesNotExist

Исключение FieldDoesNotExist вызывается методом _meta.get_field() модели, если запрошенное поле не найдено в модели или в предках модели.

MultipleObjectsReturned

exception MultipleObjectsReturned

Исключение MultipleObjectsReturned вызывается запросом при получении нескольких объектов в случае, когда ожидался один объект. Базовая версия этого исключения предоставляется модулем django.core.exceptions; каждый класс модели содержит версию подкласса, которая может использоваться для идентификации особого объектного типа, который возвратил коллекцию объектов.

См. get() для подробной информации.

SuspiciousOperation

exception SuspiciousOperation

Исключение SuspiciousOperation вызывается когда пользователь выполнил операцию, которая должна быть рассмотрена как подозрительная с точки зрения безопасности, например, при подмене куки сессии. Подклассы SuspiciousOperation:

  • DisallowedHost
  • DisallowedModelAdminLookup
  • DisallowedModelAdminToField
  • DisallowedRedirect
  • InvalidSessionKey
  • RequestDataTooBig
  • SuspiciousFileOperation
  • SuspiciousMultipartForm
  • SuspiciousSession
  • TooManyFieldsSent

Исключение SuspiciousOperation на уровне WSGI обработчика будет логгировано как ошибка и будет возвращен HttpResponseBadRequest. Подробности смотрите в разделе о логгировании.

PermissionDenied

exception PermissionDenied

Исключение PermissionDenied вызывается если пользователь не имеет права на выполнение запрошенного действия.

ViewDoesNotExist

exception ViewDoesNotExist

Исключение ViewDoesNotExist вызывается модулем django.urls, если запрошенное представление на найдено.

MiddlewareNotUsed

exception MiddlewareNotUsed

Исключение MiddlewareNotUsed вызывается, если мидлвар не используется в конфигурации сервера.

ImproperlyConfigured

exception ImproperlyConfigured

Исключение ImproperlyConfigured вызывается, если Django неправильно сконфигурировано. Например, если значение в settings.py неправильное.

FieldError

exception FieldError

Исключение FieldError вызывается, если существует проблема с полем модели. Такое может произойти по следующим причинам:

  • Поле в модели конфликтует с полем абстрактного класса, которое имеет такое же имя.
  • Бесконечный цикл, вызванный сортировкой.
  • Аргумент не может быть получен из параметров фильтра.
  • Поле не может быть определено из аргумента в параметрах запроса.
  • Объединение не разрешено для указанного поля.
  • Имя поля неверное.
  • Запрос состоит из неверного порядка аргументов.

ValidationError

exception ValidationError

Исключение ValidationError вызывается, если происходит ошибка проверки данных от формы или модели. Для подробностей о проверке данных, см. Проверка форм и полей, Проверка поля модели и the Справочник проверки.

NON_FIELD_ERRORS

NON_FIELD_ERRORS

ValidationError, которые не относятся ни к одному из полей формы или модели, классифицируются как NON_FIELD_ERRORS. Эта константа определяет ключ в словаре ошибок.

RequestAborted

exception RequestAborted
New in Django 3.0.

The RequestAborted exception is raised when a HTTP body being read in by the handler is cut off midstream and the client connection closes, or when the client does not send data and hits a timeout where the server closes the connection.

It is internal to the HTTP handler modules and you are unlikely to see it elsewhere. If you are modifying HTTP handling code, you should raise this when you encounter an aborted request to make sure the socket is closed cleanly.

SynchronousOnlyOperation

exception SynchronousOnlyOperation
New in Django 3.0.

The SynchronousOnlyOperation exception is raised when code that is only allowed in synchronous Python code is called from an asynchronous context (a thread with a running asynchronous event loop). These parts of Django are generally heavily reliant on thread-safety to function and don’t work correctly under coroutines sharing the same thread.

If you are trying to call code that is synchronous-only from an asynchronous thread, then create a synchronous thread and call it in that. You can accomplish this is with asgiref.sync.sync_to_async.

Ошибки определения URL

Ошибки определения URL определены в django.urls.

Resolver404

exception Resolver404

Исключение Resolver404 вызывается в resolve(), если путь переданный в resolve() не соответствует ни одному представлению. Подкласс django.http.Http404.

NoReverseMatch

exception NoReverseMatch

Исключение NoReverseMatch вызывается модулем django.urls, если не получилось найти соответствующий URL по переданным параметрам.

Исключения базы данных

Ошибки базы данных определены в django.db.

Django оборачивает стандартные исключения базы данных таким образом, что код Django гарантирует стандартную реализацию этих классов.

exception Error
exception InterfaceError
exception DatabaseError
exception DataError
exception OperationalError
exception IntegrityError
exception InternalError
exception ProgrammingError
exception NotSupportedError

Обёртка Django для исключений базы данных ведёт себя аналогично обёртываемым исключениям. См. PEP 249, вторую версию Python Database API Specification, для подробностей.

В соответствии с PEP 3134 атрибут __cause__ содержит изначальное исключение базы данных, предоставляя доступ к дополнительной информации.

exception models.ProtectedError

Выбрасывается для предотвращения удаления связанных объектов при использовании django.db.models.PROTECT. models.ProtectedError`является дочерним классом :exc:`IntegrityError.

Исключения Http

Ошибки HTTP определенны в django.http.

UnreadablePostError

exception UnreadablePostError

Исключение UnreadablePostError выбрасывается когда пользователь прерывает закачку файла.

Исключения транзакций

Ошибки транзакции определены в django.db.transaction.

TransactionManagementError

exception TransactionManagementError

Исключение TransactionManagementError вызывается для всех проблем с транзакциями в базе данных.

Исключения, используемые в тестах

Ошибки HTTP определенны в django.test.

RedirectCycleError

exception client.RedirectCycleError

Исключение RedirectCycleError вызывается, если тестовый клиент определил циклическое перенаправление или очень длинную цепочку перенаправлений.

Исключения Python

Django вызывает встроенные исключения Python когда это требуется. Обратитесь к документации Python для получения более подробной информации Built-in Exceptions.