如何在Django维护模式下过滤503错误的管理员邮件通知？

我之前也碰到过一模一样的问题——用django-maintenance-mode切维护模式后，满屏的503错误邮件差点把管理员邮箱炸了。不想改503成4xx（完全不符合HTTP语义），也不想每次维护都去改日志配置再还原，最后用自定义日志过滤器搞定了，完全是无hack的简洁方案，分享给你：

第一步：写个自定义日志过滤器 #

在你的项目里找个核心app（比如core或者专门放配置的app），新建filters.py文件，代码如下：

from django.utils.log import RequireDebugFalse
from maintenance_mode.core import get_maintenance_mode


class ExcludeMaintenance503Filter(RequireDebugFalse):
    def filter(self, record):
        # 先保留原有的"只在DEBUG=False时生效"的逻辑
        if not super().filter(record):
            return False
        
        # 检查两个关键条件：维护模式是否开启，以及当前日志对应的是503错误
        maintenance_active = get_maintenance_mode()
        is_503_error = getattr(record, 'status_code', None) == 503
        
        # 只要是维护模式下的503，就过滤掉这条日志，不让它发邮件
        return not (maintenance_active and is_503_error)

这个过滤器的逻辑很清晰：继承了原有的RequireDebugFalse（确保只在生产环境生效），额外加了判断——如果当前是维护模式，且日志记录的响应状态码是503，就拦截这条日志，不触发邮件通知。

第二步：更新日志配置 #

打开settings.py，找到LOGGING配置块，把原来mail_admins里的过滤器换成我们自定义的：

LOGGING = {
    # ... 其他原有配置 ...
    'filters': {
        # 可以保留原过滤器（如果其他地方用到的话）
        'require_debug_false': {
            '()': 'django.utils.log.RequireDebugFalse',
        },
        # 添加我们的自定义过滤器
        'exclude_maintenance_503': {
            '()': 'your_app_name.filters.ExcludeMaintenance503Filter',
        },
    },
    'handlers': {
        'mail_admins': {
            'level': 'ERROR',
            # 把原来的'require_debug_false'换成自定义过滤器
            'filters': ['exclude_maintenance_503'],
            'class': 'django.utils.log.AdminEmailHandler',
        },
    },
    # ... 其他原有配置 ...
}

记得把your_app_name替换成你刚才放filters.py的app名称，比如core或者config。

为什么这个方案靠谱？ #

• 完全符合语义：继续用503状态码，没有任何hack行为，严格遵循HTTP规范
• 全自动生效：维护模式开/关时，过滤器会自动识别，不需要手动修改或还原配置
• 精准过滤：只拦截维护模式下的503错误，真正的服务器错误（比如500）依然会正常发邮件通知管理员

这样配置完，下次切维护模式时，管理员邮箱就不会被503邮件轰炸了，完美解决你的问题～

内容的提问来源于stack exchange，提问作者powderflask