Python日志按天轮转配置详解

Python的TimedRotatingFileHandler按天轮转日志时看似“提前”在凌晨0点前切割，实则是因其默认依赖time.localtime()、完全忽略系统timezone设置——当服务器运行在UTC时区而业务位于东八区时，日志会在UTC 0点（即北京时间上午8点）触发轮转，造成时间错位；真正可靠的解决方案是利用atTime参数显式传入带时区的datetime.time对象（如Asia/Shanghai），尤其推荐Python 3.9+中结合zoneinfo.ZoneInfo实现精准时区对齐。

为什么 TimedRotatingFileHandler 按天切日志却总在凌晨 0 点前切？

因为默认按本地时区的 0 点切，但 Python 的 TimedRotatingFileHandler 内部用的是 time.localtime()，不感知 timezone 配置。如果你服务器时区是 UTC，而业务在东八区，它就会按 UTC 0 点（即北京时间早 8 点）切——看起来像“提前切了”。

• 真正生效的时区控制得靠 atTime 参数 + 手动算偏移：比如东八区，设 atTime=datetime.time(0, 0, 0, tzinfo=zoneinfo.ZoneInfo("Asia/Shanghai"))（Python 3.9+）
• 老版本（zoneinfo，得用 pytz 或直接传 datetime.time(16, 0)（UTC 时间下午 4 点），绕开时区逻辑
• 别信文档里“when='midnight' 就是午夜”的直觉——它只表示“每天一次”，触发时刻由 atTime 决定，不设就用当前时间的 0 点

TimedRotatingFileHandler 的 backupCount 到底删谁？

它删的是“最老的归档文件”，但判断依据不是文件修改时间，而是文件名里的日期后缀。比如 app.log.2024-05-01、app.log.2024-05-02，哪怕 05-01 文件昨天刚被 touch 过，只要名字日期更早，就会被优先清理。

• backupCount=7 表示最多保留 7 个带日期的归档 + 当前正在写的 app.log，共 8 个文件
• 注意：如果某天没写日志，就不会生成对应日期文件，空缺不占名额；但若手动改过文件名（比如加了 .bak），它就认不出来，不会删也不会轮转
• Windows 下文件名含冒号（如 app.log.2024-05-01 12:30:45）会失败——when='D' 时别用 interval 和 backupCount 混搭，默认格式就是 YYYY-MM-DD

用 logging.config.dictConfig 配置轮转日志时，哪些键不能少？

字典配置看着灵活，但漏掉 class 或 filename 会静默失效，连错误都不报——dictConfig 默认 disable_existing_loggers=True，一错就全崩。

• 必须显式写："class": "logging.handlers.TimedRotatingFileHandler"，字符串路径要完整，不能只写 TimedRotatingFileHandler
• "filename" 是绝对路径或相对路径（相对于当前工作目录，不是脚本目录），建议用 os.path.join(os.path.dirname(__file__), "logs", "app.log") 拼
• "when"、"interval"、"backupCount" 这三个是位置参数，必须作为 "kwargs" 里的键传进去，不能平级写在 handler 字典里
• 忘记配 "level" 会导致 handler 接收不到日志——root logger 默认是 WARNING，你设了 INFO 但 handler level 是 NOTSET，照样收不到

为什么日志写了半天，app.log 文件大小没变，归档也不出现？

大概率是 TimedRotatingFileHandler 的轮转时机没到，或者被其他 handler 抢先消费了日志记录。

• 检查是否设置了 delay=True（默认 False）：为 True 时，首次写日志前不创建文件，可能导致你以为“没写进去”
• 确认没有多个 handler 写同一个文件：比如既配了 FileHandler 又配了 TimedRotatingFileHandler，后者会因文件被占用而跳过轮转
• 用 logging.getLogger().handlers 打印所有 handler，看实际生效的是哪个；再查它的 baseFilename 属性，确认路径和预期一致
• 测试轮转是否正常，不要等一天：临时把 when='S'、interval=5，跑起来看 5 秒后是否生成 app.log.2024-05-01_12-00-05 类似文件

事情说清了就结束。最常卡住的地方其实是时区和 dictConfig 的键嵌套层级——这两个点不调对，其他都白配。

今天关于《Python日志按天轮转配置详解》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！