logback.xml配置文件怎么写 Spring Boot日志配置

Spring Boot 默认使用 Logback，推荐配置 logback-spring.xml 以支持 Profile 和变量绑定；基础配置含控制台与按天滚动文件日志，可按环境（dev/prod）差异化设置，支持异步、包级控制、敏感信息过滤等定制。

Spring Boot 默认使用 Logback 作为日志框架，只需在 src/main/resources 下添加 logback-spring.xml（推荐）或 logback.xml，就能覆盖默认配置。优先用 logback-spring.xml，它支持 Spring Profile、变量绑定等增强特性。

基础结构：一个可运行的 logback-spring.xml

以下是最小可用配置，支持控制台输出 + 按天滚动文件日志：

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
  <!-- 引入 Spring Boot 默认的 base 配置（含 console appender 和基本格式）-->
  <include resource="org/springframework/boot/logging/logback/defaults.xml"/>
  <include resource="org/springframework/boot/logging/logback/console-appender.xml"/>
<p><!-- 定义日志文件路径和名称 -->
<property name="LOG_PATH" value="./logs"/>
<property name="LOG_FILE" value="${LOG_PATH}/app.log"/></p><p><!-- 文件 Appender：按天滚动，保留 30 天，单文件不超过 100MB -->
<appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
<file>${LOG_FILE}</file>
<encoder>
<pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
</encoder>
<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
<fileNamePattern>${LOG_PATH}/app.%d{yyyy-MM-dd}.%i.log</fileNamePattern>
<timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
<maxFileSize>100MB</maxFileSize>
</timeBasedFileNamingAndTriggeringPolicy>
<maxHistory>30</maxHistory>
</rollingPolicy>
</appender></p><p><!-- 根 logger：控制整体日志级别和输出目标 -->
<root level="INFO">
<appender-ref ref="CONSOLE"/>
<appender-ref ref="FILE"/>
</root>
</configuration>

按环境区分日志配置（用 springProfile）

利用 <springprofile></springprofile> 标签，不同 profile 加载不同设置：

Getsound

基于当前天气条件生成个性化音景音乐

212 查看详情

• 开发环境（dev）：只输出到控制台，INFO 级别，带颜色
• 生产环境（prod）：关闭控制台，启用压缩归档，更严格级别（如 WARN）

示例片段：

<springProfile name="dev">
  <root level="INFO">
    <appender-ref ref="CONSOLE"/>
  </root>
</springProfile>
<p><springProfile name="prod">
<root level="WARN">
<appender-ref ref="FILE"/>
</root>
<!-- 可额外加异步 Appender 提升性能 -->
<appender name="ASYNC_FILE" class="ch.qos.logback.classic.AsyncAppender">
<appender-ref ref="FILE"/>
</appender>
</springProfile>

常用自定义技巧

• 动态日志路径：用 ${LOG_PATH:-./logs} 设置默认值，避免空值报错
• 包级别日志控制：比如让 MyBatis 打印 SQL，在 root 下加：

  <logger name="com.yourpackage.mapper" level="DEBUG" />
  <logger name="org.mybatis.spring" level="DEBUG" />

• 过滤敏感信息：用 PatternLayoutEncoder 配合自定义 converter，或用 Filter 拦截含密码的日志行
• 异步写日志：对 FILE appender 包一层 AsyncAppender，降低 I/O 对主线程影响

注意事项与调试建议

• 文件名必须是 logback-spring.xml 才能启用 Spring 扩展；叫 logback.xml 会跳过 profile 支持
• 修改后重启应用才生效；开发时可加 debug="true" 到 configuration 标签查看 Logback 加载过程
• 若日志没输出，检查 classpath 是否有多个 logback 配置，或是否被其他依赖（如 slf4j-simple）干扰
• 线上禁用 CONSOLE appender，避免 stdout/stderr 冲突或丢失

基本上就这些。不复杂但容易忽略细节——比如 profile 名要和 spring.profiles.active 一致，路径权限要确保应用可写，滚动策略参数大小写敏感（maxFileSize 不是 MaxFileSize）。配好之后，日志就稳了。

以上就是logback.xml配置文件怎么写 Spring Boot日志配置的详细内容，更多请关注其它相关文章！