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 RotatingFileHandler
logger = 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.2025-04-01），应改用 TimedRotatingFileHandler。

但可以组合使用逻辑：比如先用 TimedRotatingFileHandler 按天切分，再配合 maxBytes 防止单日志过大（部分 Python 版本支持该参数，需实测）；或者用外部脚本定期压缩/清理 RotatingFileHandler 生成的 .1、.2 等备份文件。

注意几个易错点

• backupCount=0 表示不保留任何备份，旧日志会被直接覆盖（不是删除，而是重命名覆盖）
• 轮转时，当前日志变为 app.log.1，已有 .1 变为 .2，以此类推；超出 backupCount 的最老文件被删除
• 多进程环境下，RotatingFileHandler 不保证线程/进程安全，可能丢日志或损坏轮转逻辑；建议搭配 ConcurrentLogHandler（第三方）或用日志代理（如 rsyslog）
• Windows *意文件锁问题，避免其他程序正打开日志文件导致轮转失败