Python日志轮转：原理、实现与生产实践

1. 日志轮转的核心价值与场景

在Python应用开发中，日志系统是排查问题、监控运行状态的基石。但未经管理的日志文件会无限增长，最终导致磁盘爆满、检索困难。我在多个生产环境中见过因日志文件过大引发的连锁反应——从简单的服务崩溃到复杂的排障延误。这就是为什么我们需要日志轮转（Log Rotation）机制。

日志轮转通过三种策略控制日志文件体积：

• 按时间轮转：每天/每周生成新文件
• 按大小轮转：达到指定体积后创建新文件
• 按数量轮转：保留固定数量的历史文件

Python标准库中的logging.handlers模块提供了现成的轮转处理器，无需第三方依赖即可实现企业级日志管理。下面这个真实案例展示了其重要性：某金融系统曾因未配置日志轮转，导致单个日志文件达到47GB，最终引发交易延迟。使用RotatingFileHandler后，日志体积始终控制在10MB以内。

2. 核心工具选型与对比

2.1 标准库中的两大利器

Python提供了两个核心轮转处理器：

1. RotatingFileHandler - 基于文件大小和数量的轮转

   python复制from logging.handlers import RotatingFileHandler
   handler = RotatingFileHandler('app.log', maxBytes=10*1024*1024, backupCount=5)
   

   参数说明：

   • maxBytes：单个文件最大字节数（示例为10MB）
   • backupCount：保留的历史文件数（示例保留5个）

2. TimedRotatingFileHandler - 基于时间的轮转

   python复制from logging.handlers import TimedRotatingFileHandler
   handler = TimedRotatingFileHandler('app.log', when='midnight', interval=1, backupCount=7)
   

   关键参数：

   • when：时间单位（'S'/秒, 'M'/分, 'H'/小时, 'D'/天, 'W'/周, 'm