Django 500 错误处理器如何获取异常详情并传递给自定义视图

9次阅读

Django 500 错误处理器如何获取异常详情并传递给自定义视图

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,才是可靠获取错误详情的正解。

text=ZqhQzanResources