Python日志切割技巧：RotatingFileHandler使用教程

今天golang学习网给大家带来了《Python日志切割技巧：RotatingFileHandler实用指南》，其中涉及到的知识点包括等等，无论你是小白还是老手，都适合看一看哦~有好的建议也欢迎大家在评论留言，若是看完有所收获，也希望大家能多多点赞支持呀！一起加油学习~

RotatingFileHandler 不支持按天轮转，因其仅依据文件大小（maxBytes）触发；需改用 TimedRotatingFileHandler 并正确配置 when='midnight' 与 atTime=time(0,0,0) 才能实现每日 00:00 准确切分。

RotatingFileHandler 为什么切不按天走？

默认情况下 RotatingFileHandler 不支持按日期轮转，它只认文件大小（maxBytes）和备份数量（backupCount）。想按天切日志，必须换用 TimedRotatingFileHandler —— 这是常见误用的根源。

如果你硬在 RotatingFileHandler 里传 when='D' 或 interval=86400，会直接报错：AttributeError: 'RotatingFileHandler' object has no attribute 'when'。

• RotatingFileHandler：只响应文件体积增长，触发条件是单个日志文件写满 maxBytes
• TimedRotatingFileHandler：才支持 when（如 'D'、'midnight'）、interval、utc 等时间参数
• 两者构造参数名相似但不兼容，混用会直接失败，不是“效果不好”，而是根本跑不起来

TimedRotatingFileHandler 的 when 参数到底怎么选？

when 控制切分时机，但不同取值行为差异很大，尤其容易踩 'D' 和 'midnight' 的坑。

• when='D'：每天固定时刻切，但这个“每天”是相对首次启动时间算的，比如程序 15:22 启动，之后每天 15:22 切，不是凌晨 00:00
• when='midnight'：才是真正按日历日切，但需配合 atTime（datetime.time 类型）才能精确到 00:00；否则默认在 00:00 切，但受首次运行时间影响可能延迟
• when='H' 或 when='M' 要慎用：interval=1 表示每小时/每分钟切一次，高频写入场景下易产生大量小文件

import logging
from logging.handlers import TimedRotatingFileHandler
from datetime import time
handler = TimedRotatingFileHandler(
filename='app.log',
when='midnight',
interval=1,
backupCount=7,
atTime=time(0, 0, 0),  # 强制在 00:00 切
encoding='utf-8'
)

日志文件名带日期后缀却乱码或格式错？

TimedRotatingFileHandler 默认用 %Y-%m-%d 格式拼接后缀，但如果你手动改过 suffix 或用了中文路径/文件名，容易出现：

• Windows 下文件名含冒号（:）被系统拒绝 → 实际生成的是 app.log.2024-05-20_00-00-00 这类安全格式，不是你写的原始 %Y-%m-%d %H:%M:%S
• 设置 suffix='%Y年%m月%d日' 后，中文导致 UnicodeEncodeError（尤其 Python 3.7 以下 + Windows）
• 没设 encoding 参数时，日志内容含中文，但轮转后新文件用系统默认编码（如 cp1252），读取时报错

解决方法：固定用 ASCII 字符命名 + 显式指定 encoding：

handler = TimedRotatingFileHandler(
    filename='app.log',
    when='midnight',
    backupCount=30,
    encoding='utf-8',  # 必加
    delay=True         # 避免启动时就创建空文件
)

多进程写同一个日志文件，轮转后旧日志被清空？

TimedRotatingFileHandler 本身**不支持多进程安全轮转**。当多个进程同时调用 doRollover()，会出现竞争：A 进程重命名旧文件，B 进程紧接着也重命名，导致一个文件被覆盖或丢失。

• 单进程没问题；多进程必须加外部协调，比如用 ConcurrentRotatingFileHandler（第三方包）
• 更稳妥的做法是：每个进程写独立文件（如加 PID 后缀），再用 logrotate 或定时脚本统一归档
• 如果坚持共用文件，至少要禁用自动删除（backupCount=0），靠外部工具清理，否则 os.rename 在多进程下不可靠

真正需要多进程安全，别硬刚内置 handler，该上 concurrent-log-handler 就上。

到这里，我们也就讲完了《Python日志切割技巧：RotatingFileHandler使用教程》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！