RotatingFileHandler 是 Python logging 模块中按大小自动轮转日志文件的处理器，支持设置单文件最大尺寸（maxBytes）和保留备份数量（backupCount），但不支持按时间轮转；需用 TimedRotatingFileHandler 实现按天切分，且多进程下非安全，应避免直接共享使用。
RotatingFileHandler 是什么
RotatingFileHandler 是 Python logging 模块中一个内置的文件处理器，用于将日志写入文件，并在文件达到指定大小或数量限制时自动轮转（即归档旧日志、新建日志文件），避免单个日志文件无限增长。
基础用法：按大小轮转
最常见的是按文件大小切割。比如限制每个日志文件最大 5MB，最多保留 5 个历史文件：
- 导入
RotatingFileHandler和logging - 创建 logger 实例并设置级别（如
INFO） - 初始化
RotatingFileHandler，传入文件路径、最大字节数（maxBytes）、备份数量（backupCount） - 添加格式器（
Formatter）和处理器到 logger
示例代码：
import logging from logging.handlers import RotatingFileHandlerlogger = logging.getLogger('my_app') logger.setLevel(logging.INFO)
handler = RotatingFileHandler( 'app.log', maxBytes=5 1024 1024, # 5MB backupCount=5 ) formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s') handler.setFormatter(formatter) logger.addHandler(handler)
logger.info('程序启动')
进阶配置：按时间 + 大小混合轮转？
RotatingFileHandler 本身不支持按时间轮转，它只响应“写入时文件超限”这一条件。如果需要每天生成新日志（如 app.log.2024-04-01），应改用 TimedRotatingFileHandler。
立即学习“Python免费学习笔记（深入）”；
但可以组合使用逻辑：比如先用 TimedRotatingFileHandler 按天切分，再配合 maxBytes 防止单日志过大（部分 Python 版本支持该参数，需实测）；或者用外部脚本定期压缩/清理 RotatingFileHandler 生成的 .1、.2 等备份文件。
注意几个易错点
-
backupCount=0表示不保留任何备份，旧日志会被直接覆盖（不是删除，而是重命名覆盖） - 轮转时，当前日志变为
app.log.1，已有.1变为.2，以此类推；超出backupCount的最老文件被删除 - 多进程环境下，
RotatingFileHandler不保证线程/进程安全，可能丢日志或损坏轮转逻辑；建议搭配ConcurrentLogHandler（第三方）或用日志代理（如 rsyslog） - Windows 下注意文件锁问题，避免其他程序正打开日志文件导致轮转失败
