RotatingFileHandler 是 Python logging 模块中按大小自动轮转日志文件的处理器，支持设置单文件最大尺寸（maxBytes）和保留备份数量（backupCount），但不支持按时间轮转；需用 TimedRotatingFileHandler 实现按天切分，且多进程下非安全，应避免直接共享使用。
RotatingFileHandler 是什么
RotatingFileHandler 是 Python logging 模块中一个内置的文件处理器，用于将日志写入文件，并在文件达到指定大小或数量限制时自动轮转（即归档旧日志、新建日志文件），避免单个日志文件无限增长。
基础用法：按大小轮转
最常见的是按文件大小切割。比如限制每个日志文件最大 5MB，最多保留 5 个历史文件：
- 导入
RotatingFileHandler和logging - 创建 logger 实例并设置级别（如
INFO） - 初始化
RotatingFileHandler，传入文件路径、最大字节数（maxBytes）、备份数量（backupCount） - 添加格式器（
Formatter）和处理器到 logger
示例代码：
huaweicloud-python-sdk-helper
下载
华为云 Python SDK 查询工具。自动发现已安装 SDK 的服务包、Client类、API 方法、入参详情、类信息（__init__ 参数、属性、类型、描述），支持关键字搜索，快速定位目标 API 使用方法。
import logging
from logging.handlers import RotatingFileHandler
<p>logger = logging.getLogger('my_app')
logger.setLevel(logging.INFO)</p><p>handler = RotatingFileHandler(
'app.log',
maxBytes=5 <em> 1024 </em> 1024, # 5MB
backupCount=5
)
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
handler.setFormatter(formatter)
logger.addHandler(handler)</p><p>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 下注意文件锁问题，避免其他程序正打开日志文件导致轮转失败
