在 Django 中处理全局异常，有几种常见的方式，通常目标是：

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

---

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

Django 有一些内置的全局错误视图（默认在 django.views.defaults 中）：

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

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

# urls.py
from django.conf.urls import handler404, handler500, handler403, handler400
from django.http import JsonResponsedef 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. 使用中间件捕获全局异常

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

# middlewares.py
import logging
from django.http import JsonResponselogger = logging.getLogger(__name__)class GlobalExceptionMiddleware:def __init__(self, get_response):self.get_response = get_responsedef __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 中注册：

MIDDLEWARE = [...'your_project.middlewares.GlobalExceptionMiddleware',
]

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

---

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

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

# settings.py
REST_FRAMEWORK = {"EXCEPTION_HANDLER": "your_project.utils.custom_exception_handler"
}

实现 custom_exception_handler：

# utils.py
from rest_framework.views import exception_handler
from rest_framework.response import Response
from rest_framework import statusdef 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。