Spring Boot中logging.file.max-history配置不生效问题咨询

问题分析 #

你使用Spring Boot 2.1.13版本时，配置的logging.file.max-size和logging.file.max-history未生效，生成的日志文件数量超过了设定的5个。这是因为默认虽以Logback为日志框架，但仅通过application.yml/properties的顶层配置，无法完全控制日志滚动与删除逻辑——这类简化配置仅对基础日志输出生效，精确的滚动与清理规则需要通过Logback专属配置文件定义。

解决方案：配置Logback实现可靠的日志自动删除 #

是的，你需要单独配置Logback来实现需求，你提到的滚动文件方案完全适用。核心是通过Logback的RollingFileAppender定义滚动触发条件与历史日志清理规则，具体步骤如下：

1. 在src/main/resources目录下创建logback-spring.xml（或logback.xml）配置文件
2. 配置RollingFileAppender，指定关键规则：
   • 按文件大小或时间触发日志滚动
   • 限制历史日志文件保留数量
   • 自动清理超出数量的旧日志

适配需求的示例配置 #

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <appender name="ROLLING_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <!-- 主日志文件路径与名称 -->
        <file>./logs/application.log</file>
        
        <!-- 滚动策略：同时按大小和时间滚动，控制历史文件数量 -->
        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            <!-- 滚动后日志文件的命名格式 -->
            <fileNamePattern>./logs/application-%d{yyyy-MM-dd}.%i.log</fileNamePattern>
            
            <!-- 单个日志文件的最大容量 -->
            <maxFileSize>10KB</maxFileSize>
            
            <!-- 最多保留的历史日志文件数量 -->
            <maxHistory>5</maxHistory>
            
            <!-- 可选：限制所有日志文件总大小，超出后自动删除最旧日志 -->
            <totalSizeCap>50KB</totalSizeCap>
        </rollingPolicy>
        
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>

    <root level="INFO">
        <appender-ref ref="ROLLING_FILE"/>
    </root>
</configuration>

配置说明 #

• SizeAndTimeBasedRollingPolicy：同时支持按文件大小和时间触发滚动，适配你的测试场景（10KB触发滚动）
• maxHistory：严格控制保留的历史日志数量，超出上限后自动删除最旧的日志文件
• totalSizeCap：可选配置，避免日志占用过多磁盘空间，超出总容量时也会自动清理旧日志

原配置失效原因 #

Spring Boot的logging.file.max-size和logging.file.max-history属于简化配置，仅在未自定义Logback配置时，由框架自动生成基础滚动策略。但这种自动生成的策略存在局限性，无法在所有场景下严格执行历史文件数量限制，因此需要通过自定义Logback配置实现精确控制。

内容的提问来源于stack exchange，提问作者user21263160