如何在Python中配置Django日志系统实现按日期切割与报警-Python教程-PHP中文网

timedrotatingfilehandler并非必不可少，而是按自然时间周期归档日志时最直接、最低侵入的官方方案；它支持“每天一个文件”等强时间语义需求，但存在非进程安全、不持久化上次轮转时间、时区与多进程下易漏滚乱序等问题。

如何在python中配置django日志系统实现按日期切割与报警

为什么直接用 `RotatingFileHandler` 不行？

因为按日期切割需要的是 TimedRotatingFileHandler，它能按天、小时等周期自动重命名并新建日志文件；而 RotatingFileHandler 是按大小轮转，和日期无关。Django 默认不启用任何轮转逻辑，全靠你在 LOGGING 配置里显式指定 handler 类型。

常见错误是把 backupCount 和 when 混在一起用——backupCount 属于 RotatingFileHandler，对 TimedRotatingFileHandler 无效；真正控制保留天数的是 backupCount + when='D' 组合，但要注意：它只清理旧文件，不自动压缩，也不保证跨重启后首次切割时机精准。

when='D' 表示每天零点切割（实际触发依赖第一次日志写入时间，不是绝对零点）
若想更准，可配 atTime=datetime.time(0, 0)，但需确保 Django 进程持续运行（gunicorn/uwsgi 下没问题，开发服务器 runserver 重启后会重置）
Windows 下注意路径分隔符，filename 建议统一用正斜杠或 os.path.join

如何在 `settings.py` 中配置带日期切割和报警的 logger

报警不是日志模块自带能力，得靠自定义 handler 或复用 SMTPHandler。Django 的 LOGGING 字典必须同时满足两件事：按天切文件 + 达到 ERROR 级别时发邮件。不能只配一个 handler，得组合使用。

关键点在于：同一个 logger 可以绑定多个 handler，比如一个给 TimedRotatingFileHandler 记所有日志，另一个给 SMTPHandler 只传 ERROR 及以上。

提示词大师-python版

图片提示词生成器？不止如此。马甲系统 —— 把脑海中的画面，翻译成AI能理解的专业表达。用得越多，它越懂你：首次需要多问几句确认方向，用久了几乎一说就懂。用得越多，它越快：缓存机制让后续对话越来越省。 RAG进化：成功案例持续入库，越跑越聪明。输入「新手指南」查看完整功能介绍

下载

LOGGING = {
    'version': 1,
    'disable_existing_loggers': False,
    'formatters': {
        'verbose': {
            'format': '{levelname} {asctime} {module} {process:d} {thread:d} {message}',
            'style': '{',
        },
    },
    'handlers': {
        'rotating_file': {
            'level': 'INFO',
            'class': 'logging.handlers.TimedRotatingFileHandler',
            'filename': 'logs/django.log',
            'when': 'D',
            'interval': 1,
            'backupCount': 30,
            'formatter': 'verbose',
            'encoding': 'utf-8',
        },
        'email_admins': {
            'level': 'ERROR',
            'class': 'django.utils.log.AdminEmailHandler',
            'include_html': True,
        },
    },
    'loggers': {
        'django': {
            'handlers': ['rotating_file', 'email_admins'],
            'level': 'INFO',
            'propagate': False,
        },
    }
}

注意：AdminEmailHandler 依赖 ADMINS 设置，且要求已配置邮箱后端（如 EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'）。没配 SMTP 时它静默失败，不会报错，容易误以为报警失效。

`TimedRotatingFileHandler` 在 Docker 或无持久卷环境下的坑

如果 Django 运行在容器里且 logs/ 目录没挂载到宿主机，每天切割产生的历史文件会随容器销毁而丢失，backupCount 形同虚设。更隐蔽的问题是：容器重启后，TimedRotatingFileHandler 会从头开始计时，导致前一天的日志被覆盖而非追加。

解决方案一：把日志目录挂载为 volume，例如 -v /host/logs:/app/logs
解决方案二：改用 WatchedFileHandler + 外部 logrotate（适合 Kubernetes），此时 Django 不管切割，由系统工具接管
避免用 delay=True，它会让首次写入前不创建文件，可能造成初期日志丢失

ERROR 报警没收到邮件？先查这三处

报警失效通常不是代码问题，而是环境或权限卡点。

检查 ADMINS 是否是元组格式：ADMINS = [('Admin', 'admin@example.com')]，漏掉逗号变成字符串就静默失败
确认 EMAIL_HOST_USER 和 EMAIL_HOST_PASSWORD 已设置，且密码支持应用专用密码（如 Gmail 开了 2FA 就必须用）
Django 默认只对 request 异常发邮件，如果你在 management command 或异步任务里主动 logger.error()，需确保该 logger 明确绑定了 email_admins handler，而不是只依赖 django.request