SpringBoot整合Logback的完整配置指南

<?xml version="1.0" encoding="UTF-8"?>
<configuration scan="true" scanPeriod="60 seconds">
    <!-- 日志文件路径 -->
    <property name="LOG_PATH" value="/var/log/seckill"/>
    <property name="LOG_NAME" value="seckill"/>
    <!-- 控制台输出 -->
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>
    <!-- 文件输出（滚动归档） -->
    <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${LOG_PATH}/${LOG_NAME}.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!-- 每天归档，保留 30 天 -->
            <fileNamePattern>${LOG_PATH}/${LOG_NAME}.%d{yyyy-MM-dd}.log</fileNamePattern>
            <maxHistory>30</maxHistory>
        </rollingPolicy>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>
    <!-- 异步输出（提升性能） -->
    <appender name="ASYNC" class="ch.qos.logback.classic.AsyncAppender">
        <appender-ref ref="FILE"/>
        <queueSize>512</queueSize>
        <discardingThreshold>0</discardingThreshold>
    </appender>
    <!-- 包级别控制 -->
    <logger name="com.zhang.seckill" level="DEBUG"/>
    <logger name="org.springframework" level="WARN"/>
    <!-- 根日志级别 -->
    <root level="INFO">
        <appender-ref ref="CONSOLE"/>
        <appender-ref ref="ASYNC"/>
    </root>
</configuration>

<!-- 核心参数说明 -->
<!-- pattern 格式说明：
     %d            → 日期时间
     %thread       → 线程名
     %-5level      → 日志级别（左对齐5位）
     %logger{36}   → 类名（缩写）
     %msg          → 日志消息
     %n            → 换行
     %line         → 行号（生产慎用，影响性能）
     %M            → 方法名（生产慎用）
-->
<!-- rollingPolicy 归档策略：
     TimeBasedRollingPolicy → 基于时间
     SizeAndTimeBasedRollingPolicy → 基于时间+大小
     maxHistory → 保留天数
-->

<!-- logback-spring.xml 通过 springProfile 区分环境 -->
<springProfile name="dev">
    <root level="DEBUG">
        <appender-ref ref="CONSOLE"/>
    </root>
</springProfile>
<springProfile name="prod">
    <root level="INFO">
        <appender-ref ref="ASYNC"/>
    </root>
</springProfile>

# 开发环境
spring:
  profiles: dev
logging:
  level:
    com.zhang: DEBUG
# 生产环境
---
spring:
  profiles: prod
logging:
  level:
    com.zhang: INFO
  file:
    path: /var/log/seckill

@Service
public class OrderService {

    private static final Logger log = LoggerFactory.getLogger(OrderService.class);

    public void createOrder(OrderDTO dto) {
        // ✅ 正确：使用占位符，不拼接字符串
        log.info("用户 {} 创建订单，金额: {}", dto.getUserId(), dto.getAmount());

        // ❌ 错误：字符串拼接，即使不输出也浪费性能
        log.info("用户 " + dto.getUserId() + " 创建订单");

        try {
            // 业务逻辑
        } catch (Exception e) {
            // ✅ 正确：打印堆栈
            log.error("创建订单失败: orderNo={}", orderNo, e);

            // ❌ 错误：不打印堆栈，无法定位
            log.error("创建订单失败: " + e.getMessage());
        }
    }
}

// ERROR：影响功能的严重错误
log.error("数据库连接失败", e);

// WARN：不影响功能但需要注意
log.warn("用户 {} 登录失败，密码错误", userId);

// INFO：关键业务流程
log.info("订单 {} 创建成功", orderNo);

// DEBUG：开发调试信息（生产关闭）
log.debug("SQL 执行结果: {}", result);

// TRACE：详细跟踪（极少使用）
log.trace("循环第 {} 次", i);

@Component
public class TraceIdInterceptor implements HandlerInterceptor {

    @Override
    public boolean preHandle(HttpServletRequest request,
                             HttpServletResponse response, Object handler) {
        // 生成或获取 TraceId
        String traceId = request.getHeader("X-Trace-Id");
        if (traceId == null || traceId.isEmpty()) {
            traceId = IdUtil.simpleUUID();
        }
        MDC.put("traceId", traceId);
        return true;
    }

    @Override
    public void afterCompletion(HttpServletRequest request,
                                HttpServletResponse response,
                                Object handler, Exception ex) {
        MDC.clear();
    }
}

<!-- logback-spring.xml 中添加 traceId 输出 -->
<encoder>
    <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level [%X{traceId}] %logger{36} - %msg%n</pattern>
</encoder>

# 检查 application.yml 中是否关闭了日志
logging:
  level:
    root: OFF   # ← 关闭了，应该改成 INFO
# 或者检查 logback-spring.xml 中 root 级别
<root level="INFO">

<!-- 按大小归档，限制每个文件大小 -->
<rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
    <fileNamePattern>${LOG_PATH}/${LOG_NAME}.%d{yyyy-MM-dd}.%i.log</fileNamePattern>
    <maxFileSize>100MB</maxFileSize>
    <maxHistory>30</maxHistory>
    <totalSizeCap>10GB</totalSizeCap>
</rollingPolicy>

# 启动前创建日志目录
mkdir -p /var/log/seckill
# 或者在配置中自动创建
<if condition='!property("LOG_PATH").equals("")'>
    <then>
        <appender name="FILE" class="...">
            <file>${LOG_PATH}/${LOG_NAME}.log</file>
        </appender>
    </then>
</if>

<!-- 秒杀系统生产环境日志配置 -->
<springProfile name="prod">
    <property name="LOG_PATH" value="/var/log/seckill"/>
    <!-- 错误日志单独归档 -->
    <appender name="ERROR_LOG" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${LOG_PATH}/error.log</file>
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <level>ERROR</level>
            <onMatch>ACCEPT</onMatch>
            <onMismatch>DENY</onMismatch>
        </filter>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${LOG_PATH}/error.%d{yyyy-MM-dd}.log</fileNamePattern>
            <maxHistory>60</maxHistory>
        </rollingPolicy>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%X{traceId}] %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>
    <root level="INFO">
        <appender-ref ref="ERROR_LOG"/>
        <appender-ref ref="ASYNC"/>
    </root>
</springProfile>

开发环境：DEBUG 级别 + 控制台输出
测试环境：INFO 级别 + 文件输出
生产环境：INFO 级别 + 异步文件输出 + 错误日志单独归档