logback.xml 日志级别配置指南

什么是 logback.xml？

logback.xml 是 Logback 日志框架的主配置文件，用于定义日志输出格式、目标（控制台/文件）、以及最重要的——日志级别。

Logback 支持的日志级别

从低到高依次为：

• TRACE：最详细的日志信息，通常仅用于开发调试
• DEBUG：调试信息，用于诊断问题
• INFO：一般性信息，如应用启动、关键流程
• WARN：警告信息，潜在问题但不影响运行
• ERROR：错误信息，已发生异常或故障

当日志级别设为 INFO 时，只会输出 INFO、WARN 和 ERROR 级别的日志。

基础 logback.xml 配置示例

<configuration>
  <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
    <encoder>
      <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
    </encoder>
  </appender>

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

上述配置将根日志级别设为 INFO，所有使用 SLF4J 或 Logback 的类默认遵循此级别。

为特定包设置不同日志级别

<logger name="com.example.service" level="DEBUG" additivity="false">
  <appender-ref ref="STDOUT" />
</logger>

此配置使 com.example.service 包下的类输出 DEBUG 及以上日志，而其他包仍使用根级别（如 INFO）。

最佳实践建议

• 生产环境建议使用 INFO 或 WARN，避免过多日志影响性能
• 开发阶段可开启 DEBUG 便于排查问题
• 敏感信息（如密码、身份证）切勿记录到日志中