Python日志轮转需用RotatingFileHandler（按大小）或TimedRotatingFileHandler（按时间）替代FileHandler；前者限单文件5MB、保留5个备份，后者支持按天/周等周期归档并自动清理旧日志。
Python日志输出到文件并实现轮转，核心是用 RotatingFileHandler 或 TimedRotatingFileHandler 替代基础的 FileHandler，配合 logging 模块的标准配置流程即可完成。关键不是“能不能写入文件”，而是“如何避免单个日志文件无限膨胀、如何按大小或时间自动归档”。
用 RotatingFileHandler 实现按大小轮转
适合日志量波动较大、更关注磁盘占用的场景。当日志文件达到指定大小，就重命名当前文件（如 app.log → app.log.1），新建空文件继续写入；超出备份数量时，最老的归档会被删除。
示例代码：
import logging
from logging.handlers import RotatingFileHandler
<p>logger = logging.getLogger('my_app')
logger.setLevel(logging.INFO)</p><h1>每个文件最大 5MB，最多保留 5 个历史备份</h1><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('服务已启动')
logger.error('发生了一个错误')
用 TimedRotatingFileHandler 实现按时间轮转
适合需要按天/小时归档、便于运维排查或对接日志分析系统的场景。支持按秒（S）、分（M）、时（H）、日（D）、周（W0–W6）、月（midnight）切分。
python-script-generator
下载
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
立即学习“Python免费学习笔记（深入）”；
常用配置说明：
-
when='D'：每天零点滚动，文件名如
app.log.2024-04-01 -
when='midnight'：同
'D'，但可配合atTime精确指定滚动时刻 -
when='W0'：每周一凌晨滚动，
W0表示周一，W1表示周二，以此类推 - backupCount=30：只保留最近 30 个周期的日志，超期自动删除
生产环境建议的组合配置
真实项目中，推荐同时启用控制台输出（方便开发调试）+ 文件轮转（保障长期运行），并统一管理日志级别和格式：
- 根 logger 设为
WARNING，避免第三方库日志刷屏 - 业务 logger 单独设为
INFO或DEBUG，精细控制输出粒度 - 文件路径使用绝对路径或基于项目根目录构造，避免因工作目录不同导致日志写入失败
- 对
RotatingFileHandler设置encoding='utf-8'，防止中文乱码 - 多进程环境下不推荐直接共用同一日志文件，应改用日志服务器（如 syslog、ELK）或加锁机制
验证与排错小技巧
轮转没生效？常见原因有：
- 日志目录不存在且无写入权限 → 手动创建目录并赋权
-
maxBytes设得太小（如 1KB），导致频繁滚动难观察 → 先调大到 1MB 测试 - 未调用
logger.info()等方法触发实际写入 → 确保有日志语句被执行 - 多个 handler 写同一个文件 → 检查是否重复
addHandler() - Windows 下文件被占用无法重命名 → 确保没有其他程序（如记事本、VS Code）正打开日志文件
