Исключения Django¶

Это исключение возникает при попытке использовать модели до завершения процедуры app loading process, которая инициализирует ORM.

Базовый класс для Model.DoesNotExist исключений. Класс try/except для ObjectDoesNotExist будет ловить DoesNotExist исключения для всех моделей.

См. get().

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

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

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

Базовый класс для Model.MultipleObjectsReturned исключений. Класс try/except для MultipleObjectsReturned будет ловить MultipleObjectsReturned исключения для всех моделей.

См. get().

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

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

Если исключение SuspiciousOperation достигает уровня обработчика ASGI/WSGI, оно регистрируется на уровне Error и приводит к появлению HttpResponseBadRequest. Дополнительную информацию см. в logging documentation.

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

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

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

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

Исключение FieldError возникает, когда возникает проблема с полем модели. Это может произойти по нескольким причинам:

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

Исключение ValidationError возникает, когда данные не проходят валидацию полей формы или модели. Подробнее о валидации см. в Form and Field Validation, Model Field Validation и Validator Reference.

Исключение BadRequest возникает, когда запрос не может быть обработан из-за ошибки клиента. Если исключение BadRequest достигает уровня обработчика ASGI/WSGI, оно приводит к возникновению HttpResponseBadRequest.

Исключение RequestAborted возникает, когда HTTP-тело, считываемое обработчиком, обрывается на середине пути и клиентское соединение закрывается, или когда клиент не отправляет данные и достигает тайм-аута, при котором сервер закрывает соединение.

Он является внутренним для модулей обработчика HTTP, и вы вряд ли увидите его где-либо еще. Если вы модифицируете код обработки HTTP, вам следует вызывать это сообщение, когда вы столкнулись с прерванным запросом, чтобы убедиться, что сокет закрыт чисто.

Исключение SynchronousOnlyOperation возникает, когда код, допустимый только в синхронном коде Python, вызывается из асинхронного контекста (потока с запущенным асинхронным циклом событий). Эти части Django в целом сильно зависят от потокобезопасности для функционирования и не работают корректно в корутинах, разделяющих один и тот же поток.

Если вы пытаетесь вызвать код, который является только синхронным, из асинхронного потока, то создайте синхронный поток и вызывайте его в нем. Этого можно добиться с помощью asgiref.sync.sync_to_async().

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

Исключение NoReverseMatch вызывается django.urls, когда подходящий URL в вашей URLconf не может быть идентифицирован на основе предоставленных параметров.

UnreadablePostError возникает, когда пользователь отменяет загрузку.

SessionInterrupted возникает, когда сессия уничтожается в параллельном запросе. Он является подклассом BadRequest.

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

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