--- title: "Django 异常" version: 3.1 locale: zh-hans source: https://docs.djangoproject.com/zh-hans/3.1/ref/exceptions/ canonical: https://djangodocs.dev/zh-hans/3.1/ref/exceptions/ --- # Django 异常 Django 会引发一些自己的异常以及标准的 Python 异常。 ## Django 核心异常 Django 核心异常类定义在 `django.core.exceptions` 中。 ### `AppRegistryNotReady` #### `exception AppRegistryNotReady` 当在初始化 ORM 的 [应用加载过程](/zh-hans/3.1/ref/applications/#app-loading-process) 完成之前，试图使用模型时，就会引发这个异常。 ### `ObjectDoesNotExist` #### `exception ObjectDoesNotExist` [`Model.DoesNotExist`](/zh-hans/3.1/ref/models/class/#django.db.models.Model.DoesNotExist) 异常的基类。一个对 `ObjectDoesNotExist` 的 `try/except` 将捕获对所有模型的 [`DoesNotExist`](/zh-hans/3.1/ref/models/class/#django.db.models.Model.DoesNotExist) 异常。 参见 [`get()`](/zh-hans/3.1/ref/models/querysets/#django.db.models.query.QuerySet.get)。 ### `EmptyResultSet` #### `exception EmptyResultSet` 如果一个查询不返回任何结果，那么 `EmptyResultSet` 可能会在生成查询的过程中被触发。大多数 Django 项目不会遇到这个异常，但它可能对实现自定义查找和表达式很有用。 ### `FieldDoesNotExist` #### `exception FieldDoesNotExist` 当请求的字段在模型或模型的父类上不存在时，模型的 `_meta.get_field()` 方法会引发 `FieldDoesNotExist` 异常。 ### `MultipleObjectsReturned` #### `exception MultipleObjectsReturned` [`Model.MultipleObjectsReturned`](/zh-hans/3.1/ref/models/class/#django.db.models.Model.MultipleObjectsReturned) 异常的基类。一个对 `MultipleObjectsReturned` 的 `try/except` 将捕获对所有模型的 [`MultipleObjectsReturned`](/zh-hans/3.1/ref/models/class/#django.db.models.Model.MultipleObjectsReturned) 异常。 参见 [`get()`](/zh-hans/3.1/ref/models/querysets/#django.db.models.query.QuerySet.get)。 ### `SuspiciousOperation` #### `exception SuspiciousOperation` [`SuspiciousOperation`](#django.core.exceptions.SuspiciousOperation) 异常是在用户进行了从安全角度看应该被认为是可疑的操作时产生的，例如篡改会话 cookie。`SuspiciousOperation` 的子类包括： - `DisallowedHost` - `DisallowedModelAdminLookup` - `DisallowedModelAdminToField` - `DisallowedRedirect` - `InvalidSessionKey` - `RequestDataTooBig` - `SuspiciousFileOperation` - `SuspiciousMultipartForm` - `SuspiciousSession` - `TooManyFieldsSent` 如果一个 `SuspiciousOperation` 异常达到 ASGI／WSGI 处理程序级别，它将被记录在 `Error` 级别，并导致一个 [`HttpResponseBadRequest`](/zh-hans/3.1/ref/request-response/#django.http.HttpResponseBadRequest)。更多信息请参见 :doc:日志文档 。 ### `PermissionDenied` #### `exception PermissionDenied` [`PermissionDenied`](#django.core.exceptions.PermissionDenied) 异常是在用户没有权限执行所请求的操作时发生的。 ### `ViewDoesNotExist` #### `exception ViewDoesNotExist` 当请求的视图不存在时， [`ViewDoesNotExist`](#django.core.exceptions.ViewDoesNotExist) 异常由 [`django.urls`](/zh-hans/3.1/ref/urlresolvers/#module-django.urls) 引发。 ### `MiddlewareNotUsed` #### `exception MiddlewareNotUsed` 当服务器配置中没有使用中间件时，会引发 [`MiddlewareNotUsed`](#django.core.exceptions.MiddlewareNotUsed) 异常。 ### `ImproperlyConfigured` #### `exception ImproperlyConfigured` [`ImproperlyConfigured`](#django.core.exceptions.ImproperlyConfigured) 异常是在 Django 配置不当的情况下产生的，例如，`settings.py` 中的一个值不正确或无法解析。 ### `FieldError` #### `exception FieldError` [`FieldError`](#django.core.exceptions.FieldError) 异常是在模型字段出现问题时引发的。发生这种情况有几种原因： - 模型中的一个字段与抽象基类中的同名字段发生冲突 - 无限循环是由排序引起的 - 不能从过滤器参数中解析关键字 - 一个字段不能通过查询参数中的关键字来确定 - 不允许在指定字段上进行 join - 字段名无效 - 查询包含无效的 order\_by 参数 ### `ValidationError` #### `exception ValidationError` 当数据未能通过表单或模型字段验证时，会引发 [`ValidationError`](#django.core.exceptions.ValidationError) 异常。关于验证的更多信息，请参见 [表单和字段验证](/zh-hans/3.1/ref/forms/validation/)、 [模型字段验证](/zh-hans/3.1/ref/models/instances/#validating-objects) 和 [验证器参考](/zh-hans/3.1/ref/validators/)。 #### `NON_FIELD_ERRORS` #### `NON_FIELD_ERRORS` `ValidationError` 不属于表格或模型中某一特定字段的错误被归类为 `NON_FIELD_ERRORS`。这个常量在字典中被用作键，否则就会将字段映射到它们各自的错误列表中。 ### `RequestAborted` #### `exception RequestAborted` > **New in Django 3.0** [`RequestAborted`](#django.core.exceptions.RequestAborted) 异常是在处理程序读入的 HTTP body 在传输流中被切断，客户端连接关闭，或者客户端不发送数据，遇到超时，服务器关闭连接时引发的。 它是 HTTP 处理模块内部的，你不太可能在其他地方看到它。如果你正在修改 HTTP 处理代码，你应该在遇到一个中止的请求时提出这个问题，以确保 socket 被干净地关闭。 ### `SynchronousOnlyOperation` #### `exception SynchronousOnlyOperation` > **New in Django 3.0** 当只有在同步 Python 代码中才允许的代码被从异步上下文（一个有正在运行的异步事件循环的线程）中调用时，会引发 [`SynchronousOnlyOperation`](#django.core.exceptions.SynchronousOnlyOperation) 异常。Django 的这些部分一般都严重依赖线程安全来运行，在协程共享同一个线程的情况下无法正常工作。 如果你想从一个异步线程中调用只用于同步的代码，那么就创建一个同步线程并在该线程中调用它。你可以通过 [`asgiref.sync.sync_to_async()`](/zh-hans/3.1/topics/async/#asgiref.sync.sync_to_async) 来实现。 ## URL 解析器异常 URL 解析器异常定义在 `django.urls` 中。 ### `Resolver404` #### `exception Resolver404` [`resolve()`](/zh-hans/3.1/ref/urlresolvers/#django.urls.resolve) 如果传递给 `resolve()` 的路径没有映射到视图，那么 [`Resolver404`](#django.urls.Resolver404) 异常就会被 [`resolve()`](/zh-hans/3.1/ref/urlresolvers/#django.urls.resolve) 引发。这是 [`django.http.Http404`](/zh-hans/3.1/topics/http/views/#django.http.Http404) 的一个子类。 ### `NoReverseMatch` #### `exception NoReverseMatch` [`NoReverseMatch`](#django.urls.NoReverseMatch) 异常是由 [`django.urls`](/zh-hans/3.1/ref/urlresolvers/#module-django.urls) 引发的，当你的 URLconf 中不能根据提供的参数识别出一个匹配的 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**](https://peps.python.org/pep-0249/)，Python 数据库 API 规范 v2.0。 根据 [**PEP 3134**](https://peps.python.org/pep-3134/)，`__cause__` 属性与原始（基础）数据库异常一起设置，允许访问提供的任何附加信息。 #### `exception models.ProtectedError` 当使用 [`django.db.models.PROTECT`](/zh-hans/3.1/ref/models/fields/#django.db.models.PROTECT) 时，为了防止删除引用对象而引发的 [`models.ProtectedError`](#django.db.models.ProtectedError) 是 [`IntegrityError`](#django.db.IntegrityError) 的子类。 #### `exception models.RestrictedError` 当使用 [`django.db.models.RESTRICT`](/zh-hans/3.1/ref/models/fields/#django.db.models.RESTRICT) 时，为了防止删除引用对象而引发的 [`models.RestrictedError`](#django.db.models.RestrictedError) 是 [`IntegrityError`](#django.db.IntegrityError) 的子类。 ## Http 异常 Http 异常可以从 `django.http` 导入。 ### `UnreadablePostError` #### `exception UnreadablePostError` [`UnreadablePostError`](#django.http.UnreadablePostError) 在用户取消上传时引发。 ## 事务异常 事务异常在 `django.db.transaction` 中定义。 ### `TransactionManagementError` #### `exception TransactionManagementError` [`TransactionManagementError`](#django.db.transaction.TransactionManagementError) 是针对与数据库事务有关的任何和所有问题提出的。 ## 测试框架异常 `django.test` 包提供的异常。 ### `RedirectCycleError` #### `exception client.RedirectCycleError` [`RedirectCycleError`](#django.test.client.RedirectCycleError) 当测试客户端检测到一个循环或过长的重定向链时，就会引发。 ## Python 异常 Django 也会在适当的时候引发内置的 Python 异常。更多关于 [Built-in Exceptions](https://docs.python.org/3/library/exceptions.html#bltin-exceptions) 的信息请参见 Python 文档。