django 1.8 官方文档翻译：6-3 Django异常

青旅半醒 2022-05-17 09:40 194阅读 0赞

# Django异常 #

DJango会抛出一些它自己的异常，以及Python的标准异常。

## Django核心异常 ##

Django核心异常类定义在`django.core.exceptions`中。

### ObjectDoesNotExist ###

\_exception \_`ObjectDoesNotExist`\[source\]

`DoesNotExist`异常的基类；对`ObjectDoesNotExist`的`try/except`会为所有模型捕获到所有`DoesNotExist` 异常。

`ObjectDoesNotExist` 和 `DoesNotExist`的更多信息请见 `get()`。

### FieldDoesNotExist ###

\_exception \_`FieldDoesNotExist`\[source\]

当被请求的字段在模型或模型的父类中不存在时，`FieldDoesNotExist`异常由模型的 `_meta.get_field()`方法抛出。

Changed in Django 1.8:

之前的版本中，异常只在`django.db.models.fields`中定义，并不是公共API的一部分。

### MultipleObjectsReturned ###

\_exception \_`MultipleObjectsReturned`\[source\]

`MultipleObjectsReturned`异常由查询产生，当预期只有一个对象，但是有多个对象返回的时候。这个异常的一个基础版本在`django.core.exceptions`中提供。每个模型类都包含一个它的子类版本，它可以用于定义返回多个对象的特定的对象类型。

详见`get()`。

### SuspiciousOperation ###

\_exception \_`SuspiciousOperation`\[source\]

当用户进行的操作在安全方面可疑的时候，抛出`SuspiciousOperation`异常，例如篡改会话cookie。`SuspiciousOperation`的子类包括：

*  `DisallowedHost`
 *  `DisallowedModelAdminLookup`
 *  `DisallowedModelAdminToField`
 *  `DisallowedRedirect`
 *  `InvalidSessionKey`
 *  `SuspiciousFileOperation`
 *  `SuspiciousMultipartForm`
 *  `SuspiciousSession`

如果`SuspiciousOperation`异常到达了WSGI处理器层，它会在`Error`层记录，并导致`HttpResponseBadRequest`异常。  
详见\_日志文档\_。

### PermissionDenied ###

\_exception \_`PermissionDenied`\[source\]

`PermissionDenied`异常当用户不被允许来执行请求的操作时产生。

### ViewDoesNotExist ###

\_exception \_`ViewDoesNotExist`\[source\]

当所请求的视图不存在时，`ViewDoesNotExist` 异常由 `django.core.urlresolvers`产生。

### MiddlewareNotUsed ###

\_exception \_`MiddlewareNotUsed`\[source\]

当中间件没有在服务器配置中出现时，产生`MiddlewareNotUsed`异常。

### ImproperlyConfigured ###

\_exception \_`ImproperlyConfigured`\[source\]

DJango配置不当时产生`ImproperlyConfigured`异常 -- 例如，`settings.py`中的值不正确或者不可解析。

### FieldError ###

\_exception \_`FieldError`\[source\]

`FieldError`异常当模型字段上出现问题时产生。它会由以下原因造成：

*  模型中的字段与抽象基类中相同名称的字段冲突。
 *  排序造成了一个死循环。
 *  关键词不能由过滤器参数解析。
 *  字段不能由查询参数中的关键词决定。
 *  连接（join）不能在指定对象上使用。
 *  字段名称不可用。
 *  查询包含了无效的 order\_by参数。

### ValidationError ###

\_exception \_`ValidationError`\[source\]

当表单或模型字段验证失败时抛出`ValidationError`异常。关于验证的更多信息，请见\_表单字段验证\_, \_模型字段验证\_ 和 \_验证器参考\_。

NON\_FIELD\_ERRORS

`NON_FIELD_ERRORS`

在表单或者模型中不属于特定字段的`ValidationError` 被归类为`NON_FIELD_ERRORS`。This constant is used as a key in dictionaries that otherwise map fields to their respective list of errors.

## URL解析器异常 ##

URL解析器异常定义在`django.core.urlresolvers`中。

### Resolver404 ###

\_exception \_`Resolver404`\[source\]

当向 `resolve()` 传递的路径不映射到视图的时候，`Resolver404`异常由`django.core.urlresolvers.resolve()`产生。 它是 `django.http.Http404`的子类。

### NoReverseMatch ###

\_exception \_`NoReverseMatch`\[source\]

当你的URLconf中的一个匹配的URL不能基于提供的参数识别时，`NoReverseMatch` 异常由 `django.core.urlresolvers` 产生。

## Database Exceptions ##

数据库异常由`django.db`导入。

Django封装了标准的数据库异常，以便确保你的DJango代码拥有这些类的通用实现。

\_exception \_`Error`