Django通过多层次机制处理异常，从Python原生try-except到框架级异常、中间件拦截及自定义错误页面。首先需关闭DEBUG模式，创建404.html和500.html模板，并在urls.py中配置handler404和handler500指向自定义视图函数，以提升用户体验与安全性。中间件的process_exception方法可在全局层面捕获异常，实现日志记录或返回JSON响应，适用于API统一错误处理。此外，结合Django日志系统可将错误输出至文件或邮件通知管理员；使用REST framework的EXCEPTION_HANDLER能精细化控制API异常响应；集成Sentry等第三方服务则提供实时监控与深度分析，增强生产环境的可观测性与稳定性。
Django的异常处理并非一个单一的模块，它更像是一个多层次、协同工作的机制，从底层的Python异常捕获到框架层面的中间件处理，再到视图函数内部的精细控制，共同构建了一个相对健壮的错误响应体系。它不只是简单地捕获错误然后抛出，更多的是提供了一套灵活的工具集，让我们能根据不同的场景，选择合适的策略来应对各种意料之外的情况，最终目标是提升应用的稳定性和用户体验。
Django在处理异常时，大致遵循一个由内到外的逻辑：首先是Python原生的
try-except
Http404
PermissionDenied
DEBUG
说实话，没有人喜欢看到一个生硬的错误页面，尤其是那种带有服务器堆栈信息的500错误，不仅不专业，还可能暴露敏感信息。所以，自定义404和500错误页面，在我看来，是任何Django项目上线前都必须做的一件事。这不只是为了好看，更是为了用户体验和安全性。
首先，确保你的
settings.py
DEBUG
False
DEBUG=True
接下来，你需要创建两个模板文件：
404.html
500.html
templates
errors
<!-- templates/404.html 示例 -->
<!DOCTYPE html>
<html lang="zh-cn">
<head>
<meta charset="UTF-8">
<title>页面未找到 - 404</title>
</head>
<body>
<h1>抱歉，页面走丢了... (404 Not Found)</h1>
<p>您访问的页面不存在，可能是链接有误，或者页面已被移除。</p>
<p>您可以尝试：</p>
<ul>
<li><a href="/">返回首页</a></li>
<li>检查URL是否正确</li>
</ul>
</body>
</html>然后，在你的项目主
urls.py
project_name/urls.py
handler404
handler500
# project_name/urls.py
from django.contrib import admin
from django.urls import path
from django.conf.urls import handler404, handler500 # 引入这行
# 假设你在某个app里定义了错误视图，或者直接在urls.py里定义
def custom_404_view(request, exception):
from django.shortcuts import render
return render(request, '404.html', status=404)
def custom_500_view(request):
from django.shortcuts import render
# 这里可以添加日志记录等逻辑
return render(request, '500.html', status=500)
urlpatterns = [
path('admin/', admin.site.urls),
# ... 其他URL模式
]
handler404 = 'project_name.urls.custom_404_view' # 或者直接用函数名
handler500 = 'project_name.urls.custom_500_view' # 注意这里没有exception参数需要注意的是，
handler404
exception
handler500
Http404
handler404
handler500
在我看来，Django的中间件机制是其异常处理体系中一个非常强大且灵活的环节。它就像一道道关卡，在请求到达视图之前或响应离开视图之后，都能进行拦截和处理。在异常处理方面，中间件的
process_exception(request, exception)
process_exception
这个方法的返回值决定了后续的处理流程：
None
process_exception
HttpResponse
自定义一个异常处理中间件，通常是为了实现一些全局性的、跨视图的错误处理逻辑，比如：
下面是一个简单的自定义异常处理中间件的例子，它会将所有未被捕获的异常记录下来，并为非
Http404
# myapp/middleware.py
import logging
from django.http import JsonResponse, Http404
from django.conf import settings
logger = logging.getLogger(__name__)
class MyExceptionHandlingMiddleware:
def __init__(self, get_response):
self.get_response = get_response
def __call__(self, request):
response = self.get_response(request)
return response
def process_exception(self, request, exception):
# Http404通常由Django自行处理，或者由handler404处理，这里可以跳过
if isinstance(exception, Http404):
return None # 让Django继续处理404，或者由handler404接管
# 记录所有未被捕获的异常
logger.exception(f"Unhandled exception caught by middleware for URL: {request.path}")
# 如果是AJAX请求，返回JSON错误
if request.headers.get('x-requested-with') == 'XMLHttpRequest' or \
'application/json' in request.META.get('HTTP_ACCEPT', ''):
status_code = 500
error_message = "服务器内部错误，请稍后再试。"
# 在DEBUG模式下，可以返回更详细的错误信息
if settings.DEBUG:
import traceback
error_message = f"DEBUG: {str(exception)}\n{traceback.format_exc()}"
return JsonResponse(
{'success': False, 'message': error_message},
status=status_code
)
# 对于非AJAX请求，让Django继续处理，最终会到handler500或默认500页面
return None
将这个中间件添加到
settings.py
MIDDLEWARE
CommonMiddleware
try-except
除了我们前面提到的自定义错误页面和中间件，Django在异常处理上还有一些更“高级”或者说更细致的策略，它们能帮助我们构建更健壮、更可观测的应用。
首先，日志系统是不可或缺的。Django内置了对Python标准库
logging
settings.py
logging
'mail_admins'
ERROR
CRITICAL
# settings.py 中的 LOGGING 配置示例
LOGGING = {
'version': 1,
'disable_existing_loggers': False,
'formatters': {
'verbose': {
'format': '{levelname} {asctime} {module} {process:d} {thread:d} {message}',
'style': '{',
},
'simple': {
'format': '{levelname} {message}',
'style': '{',
},
},
'handlers': {
'console': {
'level': 'INFO',
'class': 'logging.StreamHandler',
'formatter': 'simple'
},
'file': {
'level': 'DEBUG',
'class': 'logging.FileHandler',
'filename': '/var/log/django/debug.log', # 生产环境请修改路径
'formatter': 'verbose'
},
'mail_admins': {
'level': 'ERROR',
'class': 'django.utils.log.AdminEmailHandler',
# 'include_html': True, # 可以包含HTML格式的堆栈信息
}
},
'loggers': {
'django': {
'handlers': ['console', 'file', 'mail_admins'],
'level': 'INFO',
'propagate': True,
},
'django.request': { # 专门用于处理请求相关的日志，包括未处理的异常
'handlers': ['console', 'file', 'mail_admins'],
'level': 'ERROR',
'propagate': False, # 不再传递给父logger
},
'myapp': { # 你的应用专属logger
'handlers': ['console', 'file'],
'level': 'DEBUG',
'propagate': False,
}
},
'root': { # 根logger，处理所有未被特定logger处理的日志
'handlers': ['console', 'file'],
'level': 'WARNING',
},
}其次，对于API开发，可以考虑使用REST framework的异常处理机制。如果你正在用Django REST framework构建API，它提供了一套非常完善的异常处理流程。你可以通过
REST_FRAMEWORK
EXCEPTION_HANDLER
Response
ValidationError
PermissionDenied
# settings.py
REST_FRAMEWORK = {
'EXCEPTION_HANDLER': 'myapp.utils.custom_exception_handler',
# ... 其他设置
}
# myapp/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默认的异常处理，它会处理DRF自身的APIException
response = exception_handler(exc, context)
# 如果DRF默认处理了，就直接返回
if response is not None:
return response
# 对于其他未被DRF处理的Python异常
# 可以自定义处理逻辑
if isinstance(exc, ValueError):
return Response({'detail': '数据格式不正确'}, status=status.HTTP_400_BAD_REQUEST)
# 记录所有未被DRF处理的内部错误
import logging
logger = logging.getLogger(__name__)
logger.exception(f"Unhandled exception in API view: {context['view'].__class__.__name__}")
# 返回一个通用的500错误响应
return Response({'detail': '服务器内部错误'}, status=status.HTTP_500_INTERNAL_SERVER_ERROR)
最后，第三方错误监控服务集成，比如Sentry、Bugsnag等，是现代Web应用不可或缺的一部分。它们通过SDK集成到你的Django应用中，能够自动捕获所有未处理的异常，并提供丰富的上下文信息（如请求数据、用户信息、堆栈跟踪、环境信息等），甚至能聚合重复的错误，提供实时的错误通知和分析仪表盘。这比仅仅依靠邮件通知要强大得多，能大大提高错误发现和解决的效率。通常，你只需要安装对应的SDK，然后在
settings.py
以上就是Django 的异常处理体系解析的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
570
收藏
