### 配置 RotatingFileHandler 实现日志文件自动轮转 RotatingFileHandler 是 Python logging.handlers 模块中的一个类，用于实现日志文件的自动滚动管理。当日志文件达到指定大小时，RotatingFileHandler 会自动创建新的日志文件，并将旧日志文件重命名，从而避免单个日志文件过大[^1]。 #### 基本配置 以下是一个完整的示例，展示如何使用 `RotatingFileHandler` 实现日志文件的自动轮转： ```python import logging from logging.handlers import RotatingFileHandler import os # 设置日志目录 log_dir = "logs" if not os.path.exists(log_dir): os.makedirs(log_dir) # 创建 logger logger = logging.getLogger('RotatingLogger') logger.setLevel(logging.INFO) # 创建 RotatingFileHandler log_file = os.path.join(log_dir, "app.log") handler = RotatingFileHandler( log_file, maxBytes=1024 * 1024 * 5, # 每个日志文件最大 5MB backupCount=3, # 保留最多 3 个备份文件 encoding='utf-8' ) # 设置日志格式 formatter = logging.Formatter('%(asctime)s - %(levelname)s - %(message)s') handler.setFormatter(formatter) # 添加 handler 到 logger logger.addHandler(handler) # 示例日志输出 for i in range(10000): logger.info(f"This is a test log message {i}") ``` #### 参数说明 - `filename`：日志文件路径。 - `maxBytes`：单个日志文件的最大大小（字节），当文件达到该大小时，会触发日志滚动。 - `backupCount`：保留的备份日志文件数量。当达到 `maxBytes` 时，旧的日志文件会被重命名并保留，最多保留 `backupCount` 个历史日志文件。 - `encoding`：日志文件的编码格式，通常设置为 UTF-8。 #### 日志文件滚动行为 当主日志文件（如 `app.log`）达到 `maxBytes` 限制时，RotatingFileHandler 会将当前日志文件重命名为 `app.log.1`，并创建一个新的 `app.log` 文件继续写入日志。如果已经存在 `app.log.1`，则会依次将 `app.log.1` 重命名为 `app.log.2`，依此类推，直到保留的备份文件数量达到 `backupCount` 限制。 #### 日志轮转的优点 - **控制日志文件大小**：防止日志文件过大导致磁盘空间不足或分析困难。 - **保留历史日志**：通过备份机制，可以在不丢失重要信息的前提下管理日志文件数量。 - **自动管理**：无需手动干预即可实现日志文件的滚动与清理。 ---