
django 的 `handler500` 视图默认**不接收异常对象参数**,其函数签名固定为 `view_error_500(request)`,因此直接声明 `exception=none` 并打印 `exception` 始终为 `none`;需通过 `sys.exc_info()` 或 `traceback.format_exc()` 在视图内主动捕获当前未处理的异常上下文。
在 Django 中,handler500(即 500 Internal Server Error 处理器)是一个特殊的全局错误视图,它不接收 exception 参数——这与 handler400、handler403、handler404 等不同(后三者自 Django 3.1+ 起支持 exception 参数)。官方文档明确说明:handler500 的函数签名必须为 def view_error_500(request),Django 不会将异常实例传入该视图。
因此,你在 views_error.py 中定义 def view_error_500(request, exception=None) 并期望 exception 有值,是无效的。Django 调用时仅传入 request,exception 始终为 None。
✅ 正确做法:在 view_error_500 内部使用 Python 标准库手动提取当前线程中未捕获的异常信息:
# main/views_error.py
import sys
import traceback
from django.shortcuts import render
def view_error_500(request):
# 获取当前未处理异常的完整 traceback(仅在 handler500 中有效)
exc_type, exc_value, exc_traceback = sys.exc_info()
# 构建可读的错误详情(用于日志或模板上下文)
error_message = str(exc_value) if exc_value else "Unknown server error"
error_class = exc_type.__name__ if exc_type else "UnknownError"
full_traceback = "".join(traceback.format_exception(exc_type, exc_value, exc_traceback))
print("APP: view_error_500")
print(f"Exception: {error_class}: {error_message}")
print("Traceback:")
print(full_traceback)
# 可选:将错误信息传递给模板(注意生产环境避免泄露敏感信息!)
context = {
'error_class': error_class,
'error_message': error_message,
'debug_mode': request.settings.DEBUG if hasattr(request, 'settings') else False,
# ⚠️ 生产环境请勿直接渲染 full_traceback 到前端!
}
return render(request, "error/500.html", context, status=500)? 关键说明:
sys.exc_info() 在 handler500 执行时能准确返回导致 500 的原始异常三元组(类型、值、回溯对象),这是 Django 内部机制保障的;
traceback.format_exception() 返回格式化后的字符串列表,"".join(...) 得到标准 traceback 文本(与终端报错一致);
模板 500.html 中可根据 debug_mode 控制是否显示详细错误(开发用),生产环境应始终隐藏 full_traceback,仅记录日志;
-
确保 urls.py 中的配置正确且位于根 URL 配置末尾(无其他 handler500 覆盖):
# urls.py (根路由文件) from django.contrib import admin from django.urls import path, include urlpatterns = [ path('admin/', admin.site.urls), path('', include('main.urls')), # ... 其他路由 ] # 全局 500 处理器(必须在 urlpatterns 之后,且无引号包裹) handler500 = 'main.views_error.view_error_500'
? 补充建议(增强可观测性):
- 将 full_traceback 同步写入结构化日志(如 Sentry、ELK 或 Django 日志器):
import logging logger = logging.getLogger(__name__) logger.error("500 Internal Server Error", exc_info=True) - 若需区分错误类型(如数据库错误、权限错误),可在 full_traceback 中正则匹配或检查 exc_type,实现分级告警。
总之:不要依赖 exception 参数,而要信任 sys.exc_info() —— 这是 Django 500 处理器获取异常真相的唯一可靠方式。










