Loguru日志库中日期轮转的正确配置方法

在使用Python的Loguru日志库时，合理配置日志文件的日期轮转是一个常见需求。本文将通过一个实际案例，详细介绍如何正确设置基于日期的日志轮转功能。

问题背景

在Django REST服务中，开发者希望通过Loguru实现每日自动创建新日志文件的功能。初始配置使用了Python的f-string来动态生成包含当前日期的日志文件名：

logFile = os.path.join(logDir, f"service_{datetime.date.today()}.log")

然而这种配置方式会导致两个问题：

1. 轮转时不会创建预期的新日期文件，而是在原文件名后追加时间戳
2. 新日志内容继续写入旧日期的日志文件中

问题分析

根本原因在于f-string在程序启动时就被求值并固定下来。当Loguru执行轮转操作时，它认为这是一个静态文件名，因此采用追加时间戳的方式处理轮转文件，而不是按照开发者期望的每日创建新文件。

正确解决方案

Loguru提供了内置的时间占位符功能，可以动态处理日期变化。正确的配置方式应该是：

logFile = os.path.join(logDir, "service_{time:YYYY-MM-DD}.log")
logger.add(logFile, rotation="00:00")

这种配置的优势在于：

1. {time:YYYY-MM-DD}是Loguru的占位符语法，会在文件创建/重新创建时自动替换为当前日期
2. 配合rotation="00:00"参数，系统会在每天午夜自动轮转日志
3. 无需手动处理文件重命名逻辑，由Loguru内部自动管理

实现原理

Loguru的时间占位符功能基于以下工作机制：

1. 在初始化时，Loguru会解析文件名中的{time}格式字符串
2. 每次写入日志时，会检查当前时间是否符合轮转条件
3. 当需要轮转时，会根据当前时间重新计算文件名中的日期部分
4. 自动处理旧日志文件的归档和新日志文件的创建

最佳实践建议

1. 避免在外部计算文件名：不要使用Python的f-string或datetime计算文件名，应使用Loguru内置的占位符
2. 简化压缩逻辑：除非有特殊需求，否则不需要自定义压缩/重命名函数
3. 考虑时区因素：如果应用跨时区部署，确保服务器时间设置正确
4. 测试轮转行为：通过修改系统时间或使用特定工具验证轮转是否按预期工作

通过正确使用Loguru的时间占位符功能，开发者可以轻松实现基于日期的日志轮转，确保日志文件按天分割，便于后续的日志管理和分析。