升级Log4j 1.2 Bridge至2.17.2后RollingFileAppender MaxBackupIndex异常

问题场景 #

通过Log4j 1.2 Bridge API将Log4j从1.2.13版本升级至2.17.2版本后，原有RollingFileAppender配置的滚动归档行为不符合预期：
原有1.x配置：

log4j.appender.app=org.apache.log4j.RollingFileAppender
log4j.appender.app.layout=org.apache.log4j.PatternLayout
log4j.appender.app.layout.ConversionPattern=%d %-5p [%-4t] %c{1}.%M(%L) | %m%n
log4j.appender.app.File=${applicationLogs}/app.log
log4j.appender.app.Encoding=UTF-8
log4j.appender.app.MaxFileSize=10KB
log4j.appender.app.MaxBackupIndex=5

预期行为：

• 首次达到10KB限制：app.log归档为app.log.1，原文件截断
• 第二次达到限制：app.log.1重命名为app.log.2，app.log归档为app.log.1，原文件截断

实际异常：
第二次达到大小限制时，直接将当前app.log归档为app.log.2，未对已存在的app.log.1进行重命名，破坏了递增归档的顺序。

原因分析 #

Log4j 1.2 Bridge的RollingFileAppender本质是对Log4j 2.x原生组件的适配，两者默认的滚动策略存在差异：

• Log4j 1.x采用递增式重命名策略：旧归档文件编号依次后移，最新归档始终使用最小的可用编号（如.1）
• Log4j 2.x默认的DefaultRolloverStrategy采用直接写入最新编号逻辑，不会自动将旧归档文件编号递增，这是导致行为不一致的核心原因。

解决方案 #

方案1：改用Log4j 2.x原生配置（推荐）

将原1.x格式的properties配置转换为Log4j 2.x的XML配置，显式指定DefaultRolloverStrategy的fileIndex="max"属性，模拟1.x的递增重命名行为：

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
    <Appenders>
        <RollingFile name="app" fileName="${applicationLogs}/app.log" filePattern="${applicationLogs}/app.log.%i">
            <PatternLayout pattern="%d %-5p [%-4t] %c{1}.%M(%L) | %m%n"/>
            <Policies>
                <SizeBasedTriggeringPolicy size="10KB"/>
            </Policies>
            <!-- fileIndex="max" 启用递增式重命名，与Log4j 1.x行为一致 -->
            <DefaultRolloverStrategy fileIndex="max" max="5"/>
        </RollingFile>
    </Appenders>
    <Loggers>
        <Root level="info">
            <AppenderRef ref="app"/>
        </Root>
    </Loggers>
</Configuration>

方案2：启用Bridge兼容模式（保留1.x配置）

如果希望继续使用原1.x格式的properties配置，可在JVM启动参数中添加以下系统属性，强制Bridge使用Log4j 1.x风格的滚动逻辑：

-Dlog4j1.compatibility.rollover=true

验证方式 #

配置完成后，生成超过10KB的测试日志，观察归档文件的命名：

1. 首次滚动后生成app.log.1
2. 第二次滚动后，app.log.1应被重命名为app.log.2，同时生成新的app.log.1，原app.log被截断

内容的提问来源于stack exchange，提问作者C.U.Krishna