rotatingfilehandler 不支持按天轮转，因其仅依据文件大小（maxbytes）触发；需改用 timedrotatingfilehandler 并正确配置 when='midnight' 与 attime=time(0,0,0) 才能实现每日 00:00 准确切分。
RotatingFileHandler 为什么切不按天走？
默认情况下 RotatingFileHandler 不支持按日期轮转，它只认文件大小（maxBytes）和备份数量（backupCount）。想按天切日志，必须换用 TimedRotatingFileHandler —— 这是常见误用的根源。
如果你硬在 RotatingFileHandler 里传 when='D' 或 interval=86400，会直接报错：AttributeError: 'RotatingFileHandler' object has no attribute 'when'。
-
RotatingFileHandler：只响应文件体积增长，触发条件是单个日志文件写满maxBytes -
TimedRotatingFileHandler：才支持when（如'D'、'midnight'）、interval、utc等时间参数 - 两者构造参数名相似但不兼容，混用会直接失败，不是“效果不好”，而是根本跑不起来
TimedRotatingFileHandler 的 when 参数到底怎么选？
when 控制切分时机，但不同取值行为差异很大，尤其容易踩 'D' 和 'midnight' 的坑。
-
when='D'：每天固定时刻切，但这个“每天”是相对首次启动时间算的，比如程序 15:22 启动，之后每天 15:22 切，不是凌晨 00:00 -
when='midnight'：才是真正按日历日切，但需配合atTime（datetime.time类型）才能精确到 00:00；否则默认在 00:00 切，但受首次运行时间影响可能延迟 -
when='H'或when='M'要慎用：interval=1表示每小时/每分钟切一次，高频写入场景下易产生大量小文件
import logging from logging.handlers import TimedRotatingFileHandler from datetime import time <p>handler = TimedRotatingFileHandler( filename='app.log', when='midnight', interval=1, backupCount=7, atTime=time(0, 0, 0), # 强制在 00:00 切 encoding='utf-8' )
日志文件名带日期后缀却乱码或格式错？
TimedRotatingFileHandler 默认用 %Y-%m-%d 格式拼接后缀，但如果你手动改过 suffix 或用了中文路径/文件名，容易出现：
立即学习“Python免费学习笔记（深入）”；
- Windows 下文件名含冒号（
:）被系统拒绝 → 实际生成的是app.log.2024-05-20_00-00-00这类安全格式，不是你写的原始%Y-%m-%d %H:%M:%S - 设置
suffix='%Y年%m月%d日'后，中文导致UnicodeEncodeError（尤其 Python 3.7 以下 + Windows） - 没设
encoding参数时，日志内容含中文，但轮转后新文件用系统默认编码（如 cp1252），读取时报错
解决方法：固定用 ASCII 字符命名 + 显式指定 encoding：
handler = TimedRotatingFileHandler(
filename='app.log',
when='midnight',
backupCount=30,
encoding='utf-8', # 必加
delay=True # 避免启动时就创建空文件
)多进程写同一个日志文件，轮转后旧日志被清空？
TimedRotatingFileHandler 本身**不支持多进程安全轮转**。当多个进程同时调用 doRollover()，会出现竞争：A 进程重命名旧文件，B 进程紧接着也重命名，导致一个文件被覆盖或丢失。
- 单进程没问题；多进程必须加外部协调，比如用
ConcurrentRotatingFileHandler（第三方包） - 更稳妥的做法是：每个进程写独立文件（如加 PID 后缀），再用 logrotate 或定时脚本统一归档
- 如果坚持共用文件，至少要禁用自动删除（
backupCount=0），靠外部工具清理，否则os.rename在多进程下不可靠
真正需要多进程安全，别硬刚内置 handler，该上 concurrent-log-handler 就上。
