Django笔记三十一之全局异常处理

淡若云烟

本文首发于公众号：Hunter后端
原文链接：Django笔记三十一之全局异常处理

这一篇笔记介绍 Django 的全局异常处理。
当我们在处理一个 request 请求时，会尽可能的对接口数据的格式，内部调用的函数做一些异常处理，但可能还是会有一些意想不到的漏网之鱼，造成程序的异常导致不能正常运行，甚至会直接报给前端一个错误。
为了避免这种情况的发生，令我们的后端服务看起来是正常的，就算有报错也可以很体面的给前端一个提示，以及后端做一些错误日志的记录，这里我们引入全局异常的处理。
这里我们会用 Django 的中间件和日志的处理来实现，在本系列文章的第二十九篇和第三十篇，可以先熟悉下这两部分功能的使用。
在介绍中间件的章节，我们介绍了 __call__() 和 process_view() 函数，其实还有一个 process_exception() 函数，这个函数就是当我们的请求在发生不可预知的报错的情况下，会自动调用的函数。
我们来看这样一个处理的示例：

1. # hunter/middlewares/exception_middleware.py
3. import traceback
4. from django.http import JsonResponse
5. import logging
7. logger = logging.getLogger(__name__)
10. class ExceptionMiddleware:
12.     def __init__(self, get_response):
13.         self.get_response = get_response
15.     def __call__(self, request):
16.         response = self.get_response(request)
17.         return response
19.     def process_exception(self, request, exception):
21.         traceback_info = traceback.format_exc()
22.         logger.info(f"request_path: {request.path}, traceback_info: {traceback_info}")
23.         return JsonResponse({"code": -1, "msg": "error"}, status=500)

复制代码

在这里，我们使用 traceback.format_exc() 函数获取到 exception 的报错信息，然后通过 logger 日志打印输出。
日志信息
这里我们主要输出两个信息，一个是接口请求的路径，request.path，一个是报错信息 traceback_info，当然，这里我们还可以记录更多的信息，比如请求的用户信息，请求的参数等。
记录之后，后端就可以通过日志的具体信息去查看到底是哪里出了问题。
返回报错
在这里，调用 process_exception() 函数之后，我们这里直接 return 了 response，还有一个 http 的状态码 status=500，这些信息都是可以自己拟定的，到时候和前端约定好，检测返回了某个状态码比如 500，然后就友好的显示某个报错弹窗信息，比如后台正在处理报错等。
调用中间件
定义好这个中间件之后，我们就需要在 settings.py 里去引用这个中间件，比如这个中间件我们放置的目录是 hunter/middlewares/exception_middleware.py，就需要在 hunter/settings.py 的 MIDDLEWARE 末尾加上 'hunter.middlewares.exception_middleware.ExceptionMiddleware',  这一条。

1. # hunter/settings.py
3. MIDDLEWARE = [
4.     ...
5.     'hunter.middlewares.exception_middleware.ExceptionMiddleware',
6. ]

复制代码

测试报错
我们去尝试触发报错信息，比如之前在 第二十九篇笔记中写的一个接口，这里我们修改一下，直接报错：

1. # blog/views.py
3. from django.http import HttpResponse, JsonResponse
5. def time_view(request):
6.     html = "<h1>abc</h1>"
7.     1 / 0
8.     return HttpResponse(html)

复制代码

然后在页面或者 postman 里调用该接口，就可以在 logger 指定的日志文件里看到关于这一行的具体报错信息啦。
以上就是本篇笔记的全部内容，接下来我会接着介绍一下 Django 里 session 的一个简单应用，也就是说如何判断用户是否登录的一个示例。
如果想获取更多后端相关文章，可扫码关注阅读：

来源:https://www.cnblogs.com/hunterxiong/p/17357139.html
免责声明：由于采集信息均来自互联网，如果侵犯了您的权益，请联系我们【E-Mail:cb@itdo.tech】 我们会及时删除侵权内容，谢谢合作！