RotatingFileHandler不支持时间轮转,需继承TimedRotatingFileHandler并重写shouldRollover()添加大小判断;backupCount仅控制时间段数量,叠加大小轮转时需额外清理编号文件。
logging.handlers.RotatingFileHandler 只能按文件大小(maxBytes)或按数量(backupCount)轮转,它**完全不感知时间**,也没有 when、interval 这类参数。想实现“达到 10MB 或过了一天就切日志”,不能只靠它。
logging.handlers.TimedRotatingFileHandler 支持按时间轮转(如每天切一次),但它默认不检查文件大小。要加大小控制,得在每次写入前手动判断当前日志文件是否超限,并触发强制 rollover:
shouldRollover() 方法:除了原逻辑(时间到了?),再加一条 —— 当前文件大小 ≥ maxBytes 就返回 True
doRollover() 方法(可选):确保 rollover 后清空原文件或重命名逻辑与时间轮转兼容self.stream 的位置或 close 它,否则会破坏父类的 time-based rollover 流程示例关键片段:
class SizeAndTimeRotatingHandler(TimedRotatingFileHandler):
def __init__(self, filename, when='midnight', interval=1, backupCount=7,
encoding=None, delay=False, utc=False, atTime=None, maxBytes=0):
super().__init__(filename, when, interval, backupCount, encoding,
delay, utc, atTime)
self.maxBytes = maxBytes
def shouldRollover(self, record):
# 先让父类判断是否该按时间 rollover
tflag = super().shouldRollover(record)
if tflag:
return True
# 再检查大小
if self.maxBytes > 0 and self.stream is not None:
self
.stream.seek(0, 2) # 移动到文件末尾
if self.stream.tell() >= self.maxBytes:
return True
return False
更稳妥的做法:用 concurrent-log-handler 或 logrotate 配合
自己维护双条件 rollover 容易出竞态或遗漏边界(比如多进程写同一个文件、rollover 中断、时区切换)。生产环境建议:
maxBytes=0(禁用大小)和 when='S'(秒级)等边界场景concurrent-log-handler 包(它内部用文件锁),再配合外部 logrotate 做二次清理(例如:保留 7 天 + 每个文件不超过 100MB)backupCount 在 TimedRotatingFileHandler 中控制的是「保留多少个历史时间段的日志」(如 backupCount=7 表示留最近 7 天的 .2025-05-01、.2025-05-02…),不是「最多 7 个备份文件」。如果某天内因超大小又切了多个文件(如 app.log.2025-05-01.1、.2),这些额外文件不会被自动清理 —— 除非你额外实现 doRollover() 里遍历删除旧编号。
也就是说,大小+时间叠加后,backupCount 不再是总文件数上限,实际磁盘占用可能远超预期。