启用错误邮件通知机制

在生产环境中，建议将 DEBUG = False，以提升性能并防止敏感信息泄露。但这也意味着无法直接查看异常详情。Django 提供了自动错误上报功能，可在发生未处理异常时向管理员发送邮件。

服务器错误（500）通知

当应用抛出未捕获的异常导致 500 错误时，Django 会自动向 ADMINS 列表中的邮箱发送包含以下内容的报告：

• 错误描述
• 完整的堆栈跟踪（stack trace）
• 触发错误的 HTTP 请求详情（包括请求头、参数等）

为确保邮件正常发送，请正确配置 EMAIL_BACKEND 和相关认证信息。默认使用 root@localhost 发送，部分服务商可能拒绝该地址，建议设置 SERVER_EMAIL 指定有效发件人。

若需关闭此功能，只需清空 ADMINS 配置即可。

404 页面链接损坏通知

Django 可配置为在出现无效链接（404）时发送通知，前提是满足以下条件：

• DEBUG = False
• SEND_BROKEN_LINK_EMAILS = True
• 已启用 CommonMiddleware（默认开启）

仅当请求带有来源（Referer）且路径非忽略列表时，才会触发邮件通知，并发送至 MANAGERS 列表中的邮箱。

可通过 IGNORABLE_404_URLS 设置忽略特定路径的 404 报告，例如：

import re
IGNORABLE_404_URLS = (
    re.compile(r'^/apple-touch-icon.*\.png$'),
    re.compile(r'^/favicon\.ico$'),
    re.compile(r'^/robots\.txt$'),
)

禁用该功能最直接的方式是将 SEND_BROKEN_LINK_EMAILS 设为 False。

保护敏感数据：自定义错误信息过滤

错误报告虽有助于调试，但若包含用户密码、信用卡号等敏感字段，则存在安全风险。Django 提供两个装饰器用于控制这些信息的输出：

sensitive_variables(*vars)

标记函数中可能包含敏感数据的局部变量，使其在错误报告中被屏蔽。

from django.views.decorators.debug import sensitive_variables

@sensitive_variables('user', 'pw', 'cc')
def process_user_data(user):
    pw = user.password
    cc = user.credit_card
    name = user.username
    # 此处的 pw 与 cc 将在错误报告中显示为 ***

若不传参，将对所有局部变量进行过滤：

@sensitive_variables()
def handle_sensitive_operation():
    data = get_secret_info()
    ...

sensitive_post_parameters(*params)

专门用于过滤通过 POST 提交的参数，适用于处理用户注册、登录等场景。

from django.views.decorators.debug import sensitive_post_parameters

@sensitive_post_parameters('password', 'credit_card')
def create_profile(request):
    UserProfile.objects.create(
        user=request.user,
        password=request.POST['password'],
        credit_card=request.POST['credit_card'],
        name=request.POST['name']
    )
    # password 与 credit_card 在日志中将被替换为 ***

同样支持无参数形式，表示过滤所有 POST 参数。

自定义错误报告过滤逻辑

上述装饰器仅标记敏感项，实际过滤由内置的 django.views.debug.SafeExceptionReporterFilter 完成。如需定制行为，可创建自定义过滤类并指定：

DEFAULT_EXCEPTION_REPORTER_FILTER = 'myapp.filters.CustomExceptionFilter'

或在视图中动态指定：

def my_view(request):
    if request.user.is_authenticated:
        request.exception_reporter_filter = CustomExceptionReporterFilter()
    # ...

自定义类需继承 SafeExceptionReporterFilter，并可重写以下方法：

• is_active(self, request)：返回 True 表示当前环境应启用过滤（通常在 DEBUG=False 时激活）
• get_request_repr(self, request)：返回请求对象的字符串表示，其中 POST 数据经处理后输出
• get_post_parameters(self, request)：返回过滤后的 POST 参数字典，敏感值替换为 *
• get_traceback_frame_variables(self, request, tb_frame)：返回回溯帧中本地变量的过滤结果