Исключения Django

Это исключение возникает при попытке использовать модели до завершения процесса загрузки приложений, который инициализирует 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. Дополнительную информацию можно найти в документации по регистрации.

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

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

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

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

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

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

Исключение ValidationError возникает, когда данные не проходят валидацию полей формы или модели. Дополнительную информацию о валидации можно найти в Валидации форм и полей, Валидация полей моделей и Справочнике по валидаторам.

Исключение 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 в вашей конфигурации URL не может быть определён на основе предоставленных параметров.

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

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

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

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