如何在 Logback-Spring 中实现多路径日志输出

在Spring Boot项目里，Logback-Spring是默认的日志实现框架，相比原生Logback，它支持更多Spring相关的配置特性。当项目需要将接口请求日志、业务操作日志、错误日志分别存储到不同路径时，就需要在Logback-Spring中实现多路径日志输出。

核心实现原理

Logback的日志输出能力由Appender组件提供，每个Appender可以定义独立的日志输出路径、日志格式、滚动策略等规则。要实现多路径输出，只需要定义多个不同的Appender，再将不同的Logger和对应的Appender绑定，就可以让不同来源的日志输出到指定路径。

具体配置步骤

1. 创建Logback-Spring配置文件

在项目的src/main/resources目录下创建logback-spring.xml文件，Spring Boot会自动加载该配置文件。

2. 定义多个Appender

每个Appender对应一个独立的日志输出路径，我们可以分别定义控制台Appender、接口日志Appender、业务日志Appender、错误日志Appender。

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <!-- 定义日志文件基础路径 -->
    <property name="LOG_PATH" value="./logs"/>
    <!-- 定义日志格式 -->
    <property name="LOG_PATTERN" value="%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n"/>

    <!-- 控制台输出Appender -->
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>${LOG_PATTERN}</pattern>
            <charset>UTF-8</charset>
        </encoder>
    </appender>

    <!-- 接口请求日志Appender，输出到指定路径 -->
    <appender name="API_LOG" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <!-- 日志输出路径 -->
        <file>${LOG_PATH}/api/api.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!-- 日志滚动规则，按天切割，保留30天 -->
            <fileNamePattern>${LOG_PATH}/api/api.%d{yyyy-MM-dd}.%i.log</fileNamePattern>
            <maxHistory>30</maxHistory>
            <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
                <maxFileSize>100MB</maxFileSize>
            </timeBasedFileNamingAndTriggeringPolicy>
        </rollingPolicy>
        <encoder>
            <pattern>${LOG_PATTERN}</pattern>
            <charset>UTF-8</charset>
        </encoder>
    </appender>

    <!-- 业务操作日志Appender，输出到指定路径 -->
    <appender name="BUSINESS_LOG" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${LOG_PATH}/business/business.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${LOG_PATH}/business/business.%d{yyyy-MM-dd}.%i.log</fileNamePattern>
            <maxHistory>30</maxHistory>
            <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
                <maxFileSize>100MB</maxFileSize>
            </timeBasedFileNamingAndTriggeringPolicy>
        </rollingPolicy>
        <encoder>
            <pattern>${LOG_PATTERN}</pattern>
            <charset>UTF-8</charset>
        </encoder>
    </appender>

    <!-- 错误日志Appender，输出到指定路径 -->
    <appender name="ERROR_LOG" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${LOG_PATH}/error/error.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${LOG_PATH}/error/error.%d{yyyy-MM-dd}.%i.log</fileNamePattern>
            <maxHistory>30</maxHistory>
            <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
                <maxFileSize>100MB</maxFileSize>
            </timeBasedFileNamingAndTriggeringPolicy>
        </rollingPolicy>
        <encoder>
            <pattern>${LOG_PATTERN}</pattern>
            <charset>UTF-8</charset>
        </encoder>
        <!-- 只输出ERROR级别的日志 -->
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <level>ERROR</level>
            <onMatch>ACCEPT</onMatch>
            <onMismatch>DENY</onMismatch>
        </filter>
    </appender>
</configuration>

3. 绑定Logger和Appender

定义好Appender之后，需要将不同的Logger和对应的Appender绑定，指定哪些包或者类的日志输出到哪个路径。

<configuration>
    <!-- 上面的Appender定义内容 -->

    <!-- 接口日志Logger，绑定API_LOG Appender -->
    <logger name="com.example.demo.controller" level="INFO" additivity="false">
        <appender-ref ref="API_LOG"/>
        <appender-ref ref="CONSOLE"/>
    </logger>

    <!-- 业务日志Logger，绑定BUSINESS_LOG Appender -->
    <logger name="com.example.demo.service" level="INFO" additivity="false">
        <appender-ref ref="BUSINESS_LOG"/>
        <appender-ref ref="CONSOLE"/>
    </logger>

    <!-- 根Logger，绑定ERROR_LOG和CONSOLE Appender -->
    <root level="INFO">
        <appender-ref ref="ERROR_LOG"/>
        <appender-ref ref="CONSOLE"/>
    </root>
</configuration>

这里additivity="false"表示当前Logger的日志不会向上传递给父Logger，避免日志重复输出。如果需要日志同时输出到控制台和指定路径，可以同时添加CONSOLE的appender-ref。

代码中使用示例

在对应的类中使用日志对象打印日志，日志就会自动输出到绑定的路径。

package com.example.demo.controller;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class TestController {
    // 获取当前类的Logger，对应com.example.demo.controller包，日志会输出到api路径
    private static final Logger logger = LoggerFactory.getLogger(TestController.class);

    @GetMapping("/test")
    public String test() {
        logger.info("接口请求：/test 被调用");
        return "success";
    }
}

package com.example.demo.service;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.stereotype.Service;

@Service
public class TestService {
    // 获取当前类的Logger，对应com.example.demo.service包，日志会输出到business路径
    private static final Logger logger = LoggerFactory.getLogger(TestService.class);

    public void doBusiness() {
        logger.info("执行业务操作：新增用户");
    }
}

常见问题说明

• 如果日志没有输出到指定路径，首先检查logger标签的name属性是否和类的包路径匹配，其次检查Appender的file路径是否有写入权限。
• 如果需要按日志级别拆分路径，可以在Appender中添加对应的级别过滤器，只接收指定级别的日志。
• Logback-Spring支持使用Spring的profile配置，不同环境可以使用不同的日志路径，只需要在Appender或者Logger外面包裹<springProfile name="dev">标签即可。

Logback-Spring多路径日志输出日志配置Spring_Boot修改时间：2026-07-09 07:42:34