Исключения Django

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

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

См. get().

Базовый класс для исключений Model.NotUpdated. try/except для ObjectNotUpdated перехватит исключения NotUpdated для всех моделей.

См. save().

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

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

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

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

См. get().

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

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

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

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

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

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

Исключение 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 в вашем URLconf.

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

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

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

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