Python日志输出与轮转设置

Python日志轮转是保障服务长期稳定运行的关键实践，本文深入解析了如何通过RotatingFileHandler（按文件大小自动切割、保留指定数量备份）和TimedRotatingFileHandler（按天、周、小时等时间周期归档并清理旧日志）替代基础FileHandler，有效解决单个日志文件无限膨胀、磁盘空间耗尽及运维排查困难等痛点；不仅提供开箱即用的配置示例与生产环境推荐组合（如控制台+轮转双输出、分级日志控制、UTF-8编码防乱码），还直击常见失效场景——权限不足、路径错误、多handler冲突、Windows文件占用等，助你快速落地健壮、可维护的日志系统。

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('发生了一个错误')
</p>

用 TimedRotatingFileHandler 实现按时间轮转

适合需要按天/小时归档、便于运维排查或对接日志分析系统的场景。支持按秒（S）、分（M）、时（H）、日（D）、周（W0–W6）、月（midnight）切分。

常用配置说明：

• 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）正打开日志文件

以上就是《Python日志输出与轮转设置》的详细内容，更多关于的资料请关注golang学习网公众号！