Python日志轮转主要通过RotatingFileHandler(按大小)和TimedRotatingFileHandler(按时间)实现,分别适用于高频写入和按周期归档场景;需注意编码、权限及多进程安全问题,并推荐按天归档+控制台输出的组合配置。

Python日志轮转主要靠 logging.handlers.RotatingFileHandler 或 TimedRotatingFileHandler 实现,核心是自动归档旧日志、控制文件数量和大小,避免磁盘被撑爆。
按大小轮转:RotatingFileHandler
适合日志写入频率高、单次运行时间不固定的场景。当日志文件达到指定大小,就重命名旧文件(如 app.log.1、app.log.2),新建空文件继续写。
-
maxBytes:单个日志文件最大字节数,比如
10 * 1024 * 1024(10MB) - backupCount:最多保留几个历史备份文件,超出的自动删除
- 注意:轮转发生在下一次
logger.info()等写入时触发,不是实时检测
按时间轮转:TimedRotatingFileHandler
适合需要按天/小时归档、便于按时间排查问题的场景。支持 when='D'(每天)、'H'(每小时)、'midnight'(零点)等策略。
Python 环境工具专业版功能概述Python 环境工具专业版是一项面向实际任务的技能。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。核心要点使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。执行完成后建议检查结果是否符合预期,并保留必要记录。使用与执行同时注意输入完整性、执行条件和输出可用性。从功能定位来看,该技能
-
when 和 interval 共同决定轮转周期,例如
when='D', interval=1表示每天轮转一次 -
backupCount 同样控制保留多少个历史文件,比如保留最近7天的
app.log.2024-05-01 - 默认用
%Y-%m-%d_%H-%M-%S格式命名归档文件,可通过suffix自定义,如suffix='%Y-%m-%d'
避免常见坑:编码、权限与多进程
实际部署中容易出问题的地方:
- Windows 下中文路径或日志内容含中文,需显式指定
encoding='utf-8' - Linux 上若用 systemd 或 supervisord 启动,确保运行用户对日志目录有写权限
- 多个 Python 进程同时写同一日志文件?不要共用同一个 RotatingFileHandler —— 轮转逻辑非原子操作,会导致丢失或错乱;应改用日志服务器(如 syslog)或进程间协调方案
推荐配置模板(带格式+轮转+控制台输出)
一个开箱即用的实用组合:
- 主日志用
TimedRotatingFileHandler按天归档,保留30天 - 同时加一个
StreamHandler输出到终端,方便开发调试 - 统一使用
%(asctime)s %(levelname)-8s %(name)s %(message)s格式,时间精确到毫秒 - 设置
logger.setLevel(logging.INFO),避免 DEBUG 日志刷屏
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










