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><include resource="org/springframework/boot/logging/logback/console-appender.xml"></include><p><!-- 定义日志文件路径和名称 -->
<property name="LOG_PATH" value="./logs"></property><property name="LOG_FILE" value="${LOG_PATH}/app.log"></property></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><appender-ref ref="FILE"></appender-ref></root></p></configuration>
按环境区分日志配置（用 springProfile）
利用
- 开发环境（dev）：只输出到控制台，INFO 级别，带颜色
- 生产环境（prod）：关闭控制台，启用压缩归档，更严格级别（如 WARN）
示例片段：
<springprofile name="dev"><root level="INFO"><appender-ref ref="CONSOLE"></appender-ref></root></springprofile><p><springprofile name="prod"><root level="WARN"><appender-ref ref="FILE"></appender-ref></root><!-- 可额外加异步 Appender 提升性能 --><appender name="ASYNC_FILE" class="ch.qos.logback.classic.AsyncAppender"><appender-ref ref="FILE"></appender-ref></appender></springprofile></p>
常用自定义技巧
-
动态日志路径：用
${LOG_PATH:-./logs}设置默认值，避免空值报错 -
包级别日志控制：比如让 MyBatis 打印 SQL，在 root 下加：
<logger name="com.yourpackage.mapper" level="DEBUG"></logger><logger name="org.mybatis.spring" level="DEBUG"></logger>
-
过滤敏感信息：用
PatternLayoutEncoder配合自定义 converter，或用Filter拦截含密码的日志行 -
异步写日志：对 FILE appender 包一层
AsyncAppender，降低 I/O 对主线程影响
注意事项与调试建议
- 文件名必须是
logback-spring.xml才能启用 Spring 扩展；叫logback.xml会跳过 profile 支持 - 修改后重启应用才生效；开发时可加
debug="true"到 configuration 标签查看 Logback 加载过程 - 若日志没输出，检查 classpath 是否有多个 logback 配置，或是否被其他依赖（如 slf4j-simple）干扰
- 线上禁用
CONSOLEappender，避免 stdout/stderr 冲突或丢失
基本上就这些。不复杂但容易忽略细节——比如 profile 名要和 spring.profiles.active 一致，路径权限要确保应用可写，滚动策略参数大小写敏感（maxFileSize 不是 MaxFileSize）。配好之后，日志就稳了。
