异常 ValidationError （上）

DRF 异常

介绍

APIException 类是 DRF 异常的基类。通过继承APIException，DRF 提供了多种内置异常类。

ParseError：当请求解析失败时抛出。
AuthenticationFailed：认证失败时会出现这个异常。
NotAuthenticated：未认证的用户访问需要权限的资源时触发。
PermissionDenied：权限被拒绝时抛出该异常。
NotFound：请求的资源不存在时出现此异常。
MethodNotAllowed：使用不支持的 HTTP 方法时触发。
NotAcceptable：无法满足请求的 Accept 标头时抛出。
Throttled：请求被限流时会出现这个异常。
ValidationError：数据验证失败时触发。

通过继承 APIException 类，可以实现自定义（业务）异常。并根据业务需求在视图层返回。但这种方式比较麻烦，不太推荐。

python

from rest_framework.exceptions import APIException

class ServiceUnavailable(APIException):
    status_code = 503
    default_detail = '服务暂不可用，请稍后重试。'
    default_code = 'service_unavailable'

ValidationError 异常

rest_framework.exceptions.ValidationError异常，一般用于序列化器，在数据验证失败时自动触发。

语法：ValidationError(detail=None, code=None)
属性status_code：默认为status.HTTP_400_BAD_REQUEST
属性detail：默认为_('Invalid input.')。支持多种格式的错误信息，包括：
- 字符串：会被转换为包含该字符串的列表。
- 列表：代表多个错误信息。
- 字典：指定字段级错误，键为字段名，值为对应字段的错误信息。

手动触发ValidationError异常示例

python

from rest_framework import serializers
raise serializers.ValidationError('This field must be an integer value.')
# 或
raise serializers.ValidationError({'name': 'Please enter a valid name.'})