Django 异常Link to this heading#

当在初始化 ORM 的 应用加载过程 完成之前，试图使用模型时，就会引发这个异常。

Model.DoesNotExist 异常的基类。一个对 ObjectDoesNotExist 的 try/except 将捕获对所有模型的 DoesNotExist 异常。

参见 get()。

如果一个查询不返回任何结果，那么 EmptyResultSet 可能会在生成查询的过程中被触发。大多数 Django 项目不会遇到这个异常，但它可能对实现自定义查找和表达式很有用。

当请求的字段在模型或模型的父类上不存在时，模型的 _meta.get_field() 方法会引发 FieldDoesNotExist 异常。

Model.MultipleObjectsReturned 异常的基类。一个对 MultipleObjectsReturned 的 try/except 将捕获对所有模型的 MultipleObjectsReturned 异常。

参见 get()。

SuspiciousOperation 异常是在用户进行了从安全角度看应该被认为是可疑的操作时产生的，例如篡改会话 cookie。SuspiciousOperation 的子类包括：

• DisallowedHost

• DisallowedModelAdminLookup

• DisallowedModelAdminToField

• DisallowedRedirect

• InvalidSessionKey

• RequestDataTooBig

• SuspiciousFileOperation

• SuspiciousMultipartForm

• SuspiciousSession

• TooManyFieldsSent

• TooManyFilesSent

如果一个 SuspiciousOperation 异常达到 ASGI／WSGI 处理程序级别，它将被记录在 Error 级别，并导致一个 HttpResponseBadRequest。更多信息请参见 :doc:`日志文档 `。

PermissionDenied 异常是在用户没有权限执行所请求的操作时发生的。

当请求的视图不存在时， ViewDoesNotExist 异常由 django.urls 引发。

当服务器配置中没有使用中间件时，会引发 MiddlewareNotUsed 异常。

ImproperlyConfigured 异常是在 Django 配置不当的情况下产生的，例如，settings.py 中的一个值不正确或无法解析。

FieldError 异常是在模型字段出现问题时引发的。发生这种情况有几种原因：

• 模型中的一个字段与抽象基类中的同名字段发生冲突

• 无限循环是由排序引起的

• 不能从过滤器参数中解析关键字

• 一个字段不能通过查询参数中的关键字来确定

• 不允许在指定字段上进行 join

• 字段名无效

• 查询包含无效的 order_by 参数

当数据未能通过表单或模型字段验证时，会引发 ValidationError 异常。关于验证的更多信息，请参见 表单和字段验证、 模型字段验证 和 验证器参考。

BadRequest 异常是在请求由于客户端错误而不能被处理时引发的。如果一个 BadRequest 异常到达 ASGI／WSGI 处理程序级别，它会导致一个 HttpResponseBadRequest。

RequestAborted 异常是在处理程序读入的 HTTP body 在传输流中被切断，客户端连接关闭，或者客户端不发送数据，遇到超时，服务器关闭连接时引发的。

它是 HTTP 处理模块内部的，你不太可能在其他地方看到它。如果你正在修改 HTTP 处理代码，你应该在遇到一个中止的请求时提出这个问题，以确保 socket 被干净地关闭。

当只有在同步 Python 代码中才允许的代码被从异步上下文（一个有正在运行的异步事件循环的线程）中调用时，会引发 SynchronousOnlyOperation 异常。Django 的这些部分一般都严重依赖线程安全来运行，在协程共享同一个线程的情况下无法正常工作。

如果你想从一个异步线程中调用只用于同步的代码，那么就创建一个同步线程并在该线程中调用它。你可以通过 asgiref.sync.sync_to_async() 来实现。

resolve() 如果传递给 resolve() 的路径没有映射到视图，那么 Resolver404 异常就会被 resolve() 引发。这是 django.http.Http404 的一个子类。

NoReverseMatch 异常是由 django.urls 引发的，当你的 URLconf 中不能根据提供的参数识别出一个匹配的 URL 时会引发。

UnreadablePostError 在用户取消上传时引发。

SessionInterrupted 是当一个会话在一个并发请求中被破坏时引发的。它是 BadRequest 的一个子类。

TransactionManagementError 是针对与数据库事务有关的任何和所有问题提出的。

RedirectCycleError 当测试客户端检测到一个循环或过长的重定向链时，就会引发。