TimedRotatingFileHandler并非必不可少，而是按自然时间周期归档日志时最直接、最低侵入的官方方案；它支持“每天一个文件”等强时间语义需求，但存在非进程安全、不持久化上次轮转时间、时区与多进程下易漏滚乱序等问题。
为什么直接用 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_adminshandler，而不是只依赖django.request
最易忽略的一点：本地开发时 DEBUG=True，AdminEmailHandler 会跳过发送。上线前务必确认 DEBUG=False 且 ALLOWED_HOSTS 非空。
