自定义 exceptionreporter 专用于 debug=true 时渲染 html 错误页，需继承 django.views.debug.exceptionreporter 并重写 get_traceback_html() 或 get_template_data() 等方法，再通过 settings.py 中 default_exception_reporter 指定路径。
在 Django 项目中，自定义 ExceptionReporter 是控制异常页面（如 DEBUG=True 时的黄色错误页）内容和格式的关键方式。它不直接处理日志或 API 异常响应，而是专用于渲染开发/调试阶段的 HTML 错误详情页。要统一“全局异常变量的格式化输出标准”，需明确目标：是统一开发期错误页的展示逻辑？还是想影响所有异常的结构化输出（如 JSON API 错误）？这里聚焦前者——即定制 ExceptionReporter 本身。
理解 ExceptionReporter 的作用边界
ExceptionReporter 是 Django 内部类（django.views.debug.ExceptionReporter），仅在 DEBUG=True 且发生未捕获异常时被调用，用于生成带 traceback、request 信息、模板上下文等的 HTML 错误页面。它不参与生产环境 500 页面、不处理 logging、也不影响 REST API 的异常响应格式。若你希望统一的是 API 异常返回（如 DRF 的 APIException），应使用异常处理器（EXCEPTION_HANDLER）或中间件，而非替换 ExceptionReporter。
继承并重写 ExceptionReporter 类
创建自定义 reporter 需继承原类，并覆盖关键方法。最常用的是 get_traceback_html()（控制整个 HTML 输出）或更细粒度的 get_traceback_text()、get_template_data()：
- 在项目目录下新建
utils/debug.py（或其他合适路径） - 定义子类，例如：
from django.views.debug import ExceptionReporter<br><br>class CustomExceptionReporter(ExceptionReporter):<br> def get_traceback_html(self):<br> # 调用父类获取原始 HTML<br> html = super().get_traceback_html()<br> # 在此处插入自定义逻辑，如注入 CSS、过滤敏感变量、重排 section 顺序<br> return html.replace('<h2>Request information</h2>', '<h2>? 请求上下文</h2>')<br><br> def get_template_data(self):<br> data = super().get_template_data()<br> # 修改或添加模板上下文，比如标准化 request.META 展示字段<br> if 'request' in data and hasattr(data['request'], 'META'):<br> meta = data['request'].META<br> # 只保留常见且安全的 META 键<br> safe_meta = {k: v for k, v in meta.items() if k in ('HTTP_USER_AGENT', 'REMOTE_ADDR', 'SERVER_NAME')}<br> data['request'].META = safe_meta<br> return data
注册自定义 reporter 到 Django 设置
在 settings.py 中设置 DEFAULT_EXCEPTION_REPORTER_FILTER 和 DEFAULT_EXCEPTION_REPORTER（注意：Django 4.1+ 推荐用后者）：
DEFAULT_EXCEPTION_REPORTER = 'myproject.utils.debug.CustomExceptionReporter'- 若还需过滤 request 或 POST 数据（如隐藏密码字段），可同时配置过滤器：
DEFAULT_EXCEPTION_REPORTER_FILTER = 'myproject.utils.debug.CustomExceptionReporterFilter'（需额外实现ExceptionReporterFilter子类）
配合使用异常过滤器增强安全性
仅改 reporter 不够——原始 request.POST、request.COOKIES 等仍可能含敏感数据。应搭配自定义 ExceptionReporterFilter：
- 继承
django.views.debug.ExceptionReporterFilter - 重写
get_post_parameters()、get_user_repr()、is_safe_attribute()等方法 - 例如，在
get_post_parameters()中将'password'、'token'字段值统一替换为'[REDACTED]'
不复杂但容易忽略：自定义 reporter 仅在 DEBUG=True 时生效，生产环境需靠日志系统（如 Sentry、ELK）和 Nginx 错误页协同实现异常标准化。真正统一“全局异常输出”，应分层设计——debug 页面用 ExceptionReporter，API 响应用 DRF 异常处理器，后台任务用 logging + 过滤器，三者各司其职。
