Django全局异常处理全攻略

Django 中处理全局异常,有几种常见的方式,通常目标是:

  • 捕获项目中未被单独处理的错误
  • 统一返回给前端(如 JSON 响应 / 自定义错误页)
  • 方便记录日志

1. 使用 Django 自带的全局异常处理机制

Django 有一些内置的全局错误视图(默认在 django.views.defaults 中):

  • 404 错误:handler404
  • 500 错误:handler500
  • 403 错误:handler403
  • 400 错误:handler400

你可以在项目的 urls.py 中进行重写:

python 复制代码
# urls.py
from django.conf.urls import handler404, handler500, handler403, handler400
from django.http import JsonResponse

def custom_404(request, exception):
    return JsonResponse({"error": "页面未找到"}, status=404)

def custom_500(request):
    return JsonResponse({"error": "服务器错误"}, status=500)

def custom_403(request, exception):
    return JsonResponse({"error": "无权限访问"}, status=403)

def custom_400(request, exception):
    return JsonResponse({"error": "错误请求"}, status=400)

handler404 = custom_404
handler500 = custom_500
handler403 = custom_403
handler400 = custom_400

👉 适合处理 HTTP 层面的全局错误


2. 使用中间件捕获全局异常

如果你想在 更底层 捕获异常,可以写一个自定义中间件:

python 复制代码
# middlewares.py
import logging
from django.http import JsonResponse

logger = logging.getLogger(__name__)

class GlobalExceptionMiddleware:
    def __init__(self, get_response):
        self.get_response = get_response

    def __call__(self, request):
        try:
            return self.get_response(request)
        except Exception as e:
            logger.error(f"Unhandled Exception: {str(e)}", exc_info=True)
            return JsonResponse({"error": "服务器内部错误"}, status=500)

然后在 settings.py 中注册:

python 复制代码
MIDDLEWARE = [
    ...
    'your_project.middlewares.GlobalExceptionMiddleware',
]

👉 适合捕获 所有未被显式处理的异常,并进行日志记录 / 统一 JSON 响应。


3. Django REST Framework (DRF) 的全局异常处理

如果你用的是 DRF,可以在 settings.py 中配置全局异常处理函数:

python 复制代码
# settings.py
REST_FRAMEWORK = {
    "EXCEPTION_HANDLER": "your_project.utils.custom_exception_handler"
}

实现 custom_exception_handler

python 复制代码
# utils.py
from rest_framework.views import exception_handler
from rest_framework.response import Response
from rest_framework import status

def custom_exception_handler(exc, context):
    # 先调用 DRF 默认的异常处理
    response = exception_handler(exc, context)

    if response is None:
        # 没有被 DRF 识别的异常
        return Response({"error": "服务器内部错误"}, status=status.HTTP_500_INTERNAL_SERVER_ERROR)

    # 可以统一改造返回结构
    return Response({
        "error": response.data,
        "status_code": response.status_code
    }, status=response.status_code)

👉 适合 API 项目,能让前端统一处理错误。


4. 日志系统与监控

全局异常捕获后,还需要考虑 记录日志报警。常见做法:

  • 在中间件或异常处理函数里调用 logging,写到文件或 ELK。
  • 接入 Sentry,实时监控线上异常。

✅ 总结:

  • 普通 Django 项目:用 handler404/500/403/400 + 中间件
  • API 项目(DRF):用 自定义 exception_handler
  • 日志监控:结合 logging 或 Sentry。
相关推荐
言之。12 小时前
Django REST Framework Serializer 进阶教程
python·django·sqlite
fyakm13 小时前
python和java爬虫优劣对比
java·爬虫·python
BYSJMG13 小时前
计算机大数据毕业设计推荐:基于Spark的新能源汽车保有量可视化分析系统
大数据·分布式·python·spark·django·编辑器·课程设计
Pocker_Spades_A13 小时前
Python快速入门专业版(三):print 格式化输出:% 占位符、format 方法与 f-string(谁更高效?)
开发语言·python
nightunderblackcat14 小时前
新手向:AI IDE+AI 辅助编程
开发语言·python·microsoft·信息可视化
xdpcxq102914 小时前
Java项目打包成EXE全攻略
java·python·pycharm
Pocker_Spades_A14 小时前
Python快速入门专业版(二):print 函数深度解析:不止于打印字符串(含10+实用案例)
开发语言·python·microsoft
java1234_小锋14 小时前
[免费]基于Python的Django+Vue图书借阅推荐系统【论文+源码+SQL脚本】
开发语言·python·django
Pocker_Spades_A14 小时前
Python快速入门专业版(一):Windows/macOS/Linux 系统环境搭建(附常见报错解决)
windows·python·macos