本文详细讲解如何使用 Logback 的 CronTriggeringPolicy 和 TimeBasedRollingPolicy 实现精确到小时的日志轮转，确保每小时生成独立归档文件且永不删除。
本文详细讲解如何使用 logback 的 `crontriggeringpolicy` 和 `timebasedrollingpolicy` 实现精确到小时的日志轮转，确保每小时生成独立归档文件且永不删除。
在微服务架构中，按固定时间周期（如每小时）切分日志文件，是提升日志可维护性、便于排查与分析的关键实践。Logback 原生支持基于时间的滚动策略，但默认的 TimeBasedRollingPolicy 仅依据日志文件的起始时间戳触发归档（例如：%d{yyyy-MM-dd HH} 每小时生成新文件），并不保证严格按时触发——尤其当应用启动时间不在整点时，首文件可能跨越多个小时。要实现「严格每小时整点归档」（如 00:00、01:00、02:00…），必须引入 CronTriggeringPolicy。
✅ 正确配置要点
-
启用
CronTriggeringPolicy：它基于 Quartz Cron 表达式控制滚动时机，确保精确到分钟级的触发； -
禁用
maxHistory的自动清理逻辑（因需求要求“不删除任何归档文件”）； -
避免混用
totalSizeCap或maxHistory与CronTriggeringPolicy，否则可能干扰定时行为； -
fileNamePattern中时间占位符需与 cron 精度匹配（如每小时归档，应使用%d{yyyy-MM-dd_HH}或%d{yyyy-MM-dd HH}）。
✅ 推荐配置示例（每小时整点归档，永久保留）
<configuration><property name="LOG_PATH" value="logs"></property><property name="ARCHIVE_PATH" value="${LOG_PATH}/archived"></property><appender name="FILE-ROLLING" class="ch.qos.logback.core.rolling.RollingFileAppender"><!-- 主日志文件（当前写入文件） --><file>${LOG_PATH}/campaign-service.log</file><rollingpolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy"><!-- 归档文件命名格式：campaign-service.2024-05-20_14.log --><filenamepattern>${ARCHIVE_PATH}/campaign-service.%d{yyyy-MM-dd_HH}.log</filenamepattern><!-- ⚠️ 关键：启用 Cron 触发器，每小时整点触发（秒=0，分=0，时=* → 每小时00:00） --><triggeringpolicy class="ch.qos.logback.core.rolling.CronTriggeringPolicy"><schedule>0 0 0/1 * * ?</schedule><evaluateonstartup>true</evaluateonstartup></triggeringpolicy><!-- ⚠️ 不设 maxHistory，避免自动删除；若需限制磁盘占用，后期可手动清理或用外部脚本 --><!-- <maxHistory>0</maxHistory> （Logback 1.4+ 支持 0 表示不限制；旧版本留空即可） --></rollingpolicy><encoder><pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern></encoder></appender><!-- 根日志器或指定包启用该 appender --><root level="INFO"><appender-ref ref="FILE-ROLLING"></appender-ref></root><!-- 可选：单独为业务包配置 --><logger name="com.credence" level="TRACE" additivity="false"><appender-ref ref="FILE-ROLLING"></appender-ref></logger></configuration>
? Cron 表达式说明
0 0 0/1 * * ? 含义如下：
-
0秒 → 每分钟第 0 秒触发 -
0分 → 每小时第 0 分（即整点） -
0/1时 → 从 0 点开始，每 1 小时执行一次（0,1,2,...23） -
*日、*月、?周 → 不限定日期，仅按小时触发
✅ 效果：无论应用何时启动，首次归档将在下一个整点（如 14:00）发生，之后严格每小时归档一次（15:00、16:00…），生成形如 campaign-service.2024-05-20_14.log 的文件。
⚠️ 注意事项
-
Logback 版本要求：
CronTriggeringPolicy自 Logback 1.3.0 起正式支持（推荐使用 1.4.x 或更高版本）； -
路径权限：确保应用对
logs/和logs/archived/目录有读写权限，必要时提前创建目录； -
避免重复配置 logger：原示例中
com.credence被定义了两次，会导致日志重复输出，应合并为单个 - 性能考量：高频归档（如每分钟）可能增加 I/O 开销，每小时属合理粒度，无需额外优化。
通过以上配置，你将获得稳定、精准、可追溯的小时级日志归档能力，满足生产环境对日志生命周期管理的严格要求。
