Log4j2 RollingFile 仅保留最近4天日志的解决方案

log4j2 默认滚动策略会限制归档日志数量,若未显式配置 `defaultrolloverstrategy` 的 `max` 参数,其默认值为 7(但受 `filepattern` 中日期格式与目录结构影响,实际可能被误判为“按天归档+按序编号”,导致仅保留最近4个滚动单元)。本文详解如何通过正确配置 `defaultrolloverstrategy` 和归档清理策略,实现按日期目录归档并长期保留指定天数的日志。

Log4j2 的 RollingFileAppender 在触发滚动(如按大小或启动时)后,会根据 filePattern 生成新文件,并由 Rollover Strategy 决定如何管理旧日志——包括重命名、压缩、移动及自动删除过期文件。您当前配置中完全缺失 元素,因此 Log4j2 启用了默认策略:max = 7(即最多保留7个归档文件),且该计数基于滚动序列号 %i,而非日期。

但您的 filePattern 是:

filePattern="/mnt/logbackups/$${date:dd-MM-yyyy}/myservice-%d{dd-MM-yyyy}-%i.log.gz"

这会导致两个关键问题:

  1. $${date:dd-MM-yyyy} 是静态插值(仅在启动时计算一次),无法按天动态创建目录;
  2. %d{dd-MM-yyyy} 在 filePattern 中是归档时间占位符,但与 fileName 不匹配,且与 %i(索引)混用,使 Log4j2 将每个“日期+索引”组合视为独立归档单元,而默认 max=7 实际作用于整个归档池——当某天产生多个 %i 文件(如因频繁滚动),很快耗尽配额,旧文件被轮替删除,表现为“只留最近4天”。

✅ 正确做法是:明确声明 DefaultRolloverStrategy,并结合 Delete 行为按日期清理(推荐方式),或使用 DirectWriteRolloverStrategy(需 Log4j2 ≥ 2.19.0)。

✅ 推荐方案:使用 Delete 归档清理策略(Log4j2 ≥ 2.5)

修改后的完整 RollingFile 配置如下(关键改动已加注释):


    filePattern="/mnt/logbackups/%d{yyyy-MM-dd}/myservice-%d{yyyy-MM-dd}-%i.log.gz">
    
        %d{yyyy-MM-dd HH:mm:ss.SSS} %-5p (%t) %c{1.} %m%n
    
    
        
        
        
        
    
    
    
        
        
            
            
            
            
                
                
                    
                
            
        
    

? 关键说明

  • basePath="/mnt/logbackups":指定清理根路径;
  • maxDepth="2":允许遍历子目录(如 /mnt/logbackups/2025-05-01/);
  • :删除最后修改时间早于7天的目录(即保留最近7天);
  • 确保只匹配目录(Unix风格),避免误删日志文件;
  • 务必先启用 testMode="true" 测试(如 ),确认日志输出中显示“Would delete…”而非实际删除。

⚠️ 注意事项

  • $$ 是错误写法,应为 $($${date:...} 中的 $ 是变量引用符号,$$ 会被转义为单 $,导致路径解析失败);
  • fileName 必须是当前活动日志的绝对路径,不可含日期占位符;
  • 若需严格按“年/月/日”三级目录,将 filePattern 改为:
    "/mnt/logbackups/%d{yyyy}/%d{MM}/%d{dd}/myservice-%d{yyyy-MM-dd}-%i.log.gz",并同步调整 Delete 的 basePath 和过滤逻辑;
  • TimeBasedTriggeringPolicy 与 OnStartupTriggeringPolicy 可共存,确保每天至少滚动一次(即使无新日志)。

通过以上配置,您将彻底解决“仅保留4天”的问题,并实现可预测、可审计的日志生命周期管理。