
django 的 `handler500` 视图默认不接收异常对象,仅接收 `request` 参数;需通过 `sys.exc_info()` 或 `traceback.format_exc()` 在视图内部捕获当前未处理的异常上下文。
在 Django 中,handler500(即服务器内部错误处理器)的设计初衷是兜底响应,因此其签名严格限定为 def view_error_500(request),不支持 exception 参数——这与 handler400、handler403、handler404 等不同(它们在 Django 3.2+ 中才正式支持 exception 参数,而 handler500 始终不支持)。因此,你在 urls.py 中写 handler500 = 'main.views_error.view_error_500' 并期望 exception=None 被自动传入,是无效的;Django 根本不会向该函数传递第二个参数,exception 始终为 None。
✅ 正确做法:在 view_error_500 内部主动获取当前异常上下文。推荐使用标准库 traceback 模块:
# main/views_error.py
import traceback
from django.shortcuts import render
def view_error_500(request):
# 获取当前未捕获异常的完整回溯字符串(仅在500处理器中有效)
error_text = traceback.format_exc()
print("APP: view_error_500")
print("Exception traceback:")
print(error_text)
# 可选:解析异常类型和消息用于日志或模板渲染
exc_type, exc_value, exc_traceback = traceback.sys.exc_info()
context = {
'exception_type': exc_type.__name__ if exc_type else 'Unknown',
'exception_message': str(exc_value) if exc_value else '',
'debug_mode': request.settings.DEBUG, # 注意:settings 需从 request 或全局导入
}
return render(request, "error/500.html", context, status=500)⚠️ 重要注意事项:
- traceback.format_exc() 仅在异常正在被处理的上下文中有效(即 handler500 被调用时),它依赖 Python 的 sys.exc_info(),而该信息在 500 处理器执行期间仍保留。
- 不要尝试在 handler500 中 try/except ——此时异常已发生且未被捕获,except 块不会触发。
- 生产环境切勿在 500.html 中直接暴露 error_text 给用户(存在安全风险),应仅用于日志记录或内部调试;模板中可显示友好提示,如“服务暂时不可用,请稍后重试”。
- 若需结构化错误上报(如发送到 Sentry),建议在此处调用错误监控 SDK,并传入 exc_info=sys.exc_info()。
? 补充技巧:如需访问请求相关元数据(如 request.path, request.user, request.META),可一并注入模板上下文,便于排查问题来源。
总之,Django 的 handler500 是一个“无参但有上下文”的特殊钩子——放弃等待 exception 参数,转而信任 traceback,才是可靠获取错误详情的正解。










