Django+DRF 实战:自定义异常处理流程

一、DRF 异常处理流程

DRF 默认异常处理流程

DRF默认的异常处理流程如下:

  1. 当异常发生时,会自动调用rest_framework.views.exception_handler 函数来处理异常。
  2. 该函数对DRF异常(即继承了APIException 类)和Django内置的Http404、PermissionDenied异常,提取错误信息并返回响应
  3. 其它异常不处理,返回None(抛出到外层)。

源码

下面是DRF的exception_handler 异常处理函数源码

python 复制代码
# rest_framework.views.py
def exception_handler(exc, context):
    if isinstance(exc, Http404):
        exc = exceptions.NotFound(*(exc.args))
    elif isinstance(exc, PermissionDenied):
        exc = exceptions.PermissionDenied(*(exc.args))

    if isinstance(exc, exceptions.APIException):
        headers = {}
        if getattr(exc, 'auth_header', None):
            headers['WWW-Authenticate'] = exc.auth_header
        if getattr(exc, 'wait', None):
            headers['Retry-After'] = '%d' % exc.wait

        if isinstance(exc.detail, (list, dict)):
            data = exc.detail
        else:
            data = {'detail': exc.detail}

        set_rollback()
        return Response(data, status=exc.status_code, headers=headers)

    return None

二、实战

DRF 自定义异常处理流程

DRF 自定义异常处理流程示例:

  1. 定义custom_exception_handler函数,作为DRF的全局异常处理器
  2. 该函数记录详细的错误日志,包括用户、IP、请求路径、方法、视图及异常信息。然后,统一返回错误响应格式
    • 若异常未被 DRF 捕获,返回 500 错误或特定 ProtectedError 提示
    • 若为 DRF 的 ValidationError 或 Django 的验证错误,调用对应处理函数提取错误信息
    • 其他异常则根据状态码返回预定义的友好提示

应用自定义异常处理流程

settings.py 中,配置DRF自定义异常处理函数,作为全局异常处理器。

python 复制代码
REST_FRAMEWORK = {
    # ...
    # 全局异常处理
    "EXCEPTION_HANDLER": "mars_framework.exceptions.base.custom_exception_handler",
    # ...
}

点击查看完成代码


您正在阅读的是《Django从入门到实战》专栏!关注不迷路~

相关推荐
用户214118326360242 分钟前
Qwen3-VL 接口部署全攻略:从源码到 Docker,手把手教你玩转多模态调用
后端
databook1 小时前
Manim实现旋转扭曲特效
后端·python·动效
karry_k1 小时前
ThreadLocal原理以及内存泄漏
java·后端·面试
MrSun的博客1 小时前
数据源切换之道
后端
Keepreal4961 小时前
1小时快速上手SpringBoot,熟练掌握CRUD
spring boot·后端
豆浆Whisky1 小时前
Go interface性能调优指南:避免常见陷阱的实用技巧|Go语言进阶(10)
后端·go
IT_陈寒2 小时前
「Redis性能翻倍的5个核心优化策略:从数据结构选择到持久化配置全解析」
前端·人工智能·后端
风象南3 小时前
SpringBoot安全进阶:利用门限算法加固密钥与敏感配置
后端
数据知道4 小时前
Go语言:用Go操作SQLite详解
开发语言·后端·golang·sqlite·go语言
你的人类朋友10 小时前
【Node】单线程的Node.js为什么可以实现多线程?
前端·后端·node.js