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

畫卷琴夢
发布: 2025-12-13 18:31:29
原创
975人浏览过
Spring Boot 默认使用 Logback,推荐配置 logback-spring.xml 以支持 Profile 和变量绑定;基础配置含控制台与按天滚动文件日志,可按环境(dev/prod)差异化设置,支持异步、包级控制、敏感信息过滤等定制。

logback.xml配置文件怎么写 spring boot日志配置

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 加载不同设置:

DeepBrain
DeepBrain

AI视频生成工具,ChatGPT +生成式视频AI =你可以制作伟大的视频!

DeepBrain 146
查看详情 DeepBrain
  • 开发环境(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日志配置的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号