日志记录是任何应用程序的关键方面，提供了对应用程序运行时行为的可见性。在 Spring Boot 中，日志子系统高度可配置，并支持多种日志框架和模式。本博客探讨了 Spring Boot 应用程序中常见的日志模式、它们的配置以及实际用例。

1. Spring Boot 日志记录简介

Spring Boot 使用 SLF4J （Java 的简单日志门面）作为日志抽象，并将其与默认的日志实现 Logback 集成。然而，Spring Boot 也支持其他日志框架，如 Log4j2 和 Java Util Logging (JUL) 。

Spring Boot 日志记录的关键特性：

• 预配置了合理的默认值。
• 易于使用 application.properties 或 application.yml 进行自定义。
• 支持外部配置文件。

2. 在 Spring Boot 中设置日志记录

Spring Boot 提供了默认配置，但您可以根据需求覆盖它们。Logback 的关键配置文件是 logback-spring.xml 。对于 Log4j2，它是 log4j2-spring.xml 。

默认配置：

默认情况下，Spring Boot 使用以下模式将日志输出到控制台：

[yyyy-MM-dd HH:mm:ss] [LEVEL] [thread-name] logger-name: message

示例：

2025-01-23 10:15:30 INFO [main] com.example.DemoApplication: Application started successfully.

添加日志记录依赖项：

如果你想切换到不同的日志框架，请将相应的依赖项添加到你的 pom.xml （对于 Maven）：

Log4j2:

<dependency>

<groupId>org.springframework.boot</groupId>

<artifactId>spring-boot-starter-log4j2</artifactId>

</dependency>

Logback（默认）：

<dependency>

<groupId>org.springframework.boot</groupId>

<artifactId>spring-boot-starter-logging</artifactId>

</dependency>

3. 日志记录模式的类型

3.1 简单模式

简单模式简洁明了，仅显示日期、日志级别和消息等基本信息。

配置在 application.properties :

logging.pattern.console=%d{yyyy-MM-dd HH:mm:ss} [%p] %m%n

示例输出：

2025-01-23 10:20:00 [INFO] Application started.

3.2 JSON 日志记录模式

JSON 日志记录对于结构化日志记录非常有用，尤其是在分布式系统中。

logback-spring.xml 中的配置：

<configuration>

<appender name="JSON_CONSOLE" class="ch.qos.logback.core.ConsoleAppender">

<encoder class="net.logstash.logback.encoder.LoggingEventCompositeJsonEncoder"/>

</appender>

<root level="info">

<appender-ref ref="JSON_CONSOLE"/>

</root>

</configuration>

示例输出：

{

"timestamp": "2025-01-23T10:22:00.123Z",

"level": "INFO",

"logger": "com.example.DemoApplication",

"message": "Application started"

}

3.3 颜色编码控制台模式

颜色编码的日志增强了终端环境中的可读性。

application.properties 中的配置：

logging.pattern.console=%clr(%d{yyyy-MM-dd HH:mm:ss}){faint} %clr([%p]){highlight} %clr(%c{1.}){cyan}: %m%n%wEx

示例输出：控制台中的彩色输出，其中不同的日志级别（INFO、ERROR、WARN）以不同的颜色显示。

3.4 滚动文件日志记录模式

此模式涉及将日志写入文件，并在满足特定条件（例如，文件大小或日期）时进行滚动更新。

配置在 logback-spring.xml ：

<configuration>

<appender name="ROLLING" class="ch.qos.logback.core.rolling.RollingFileAppender">

<file>logs/application.log</file>

<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">

<fileNamePattern>logs/application-%d{yyyy-MM-dd}.log</fileNamePattern>

<maxHistory>7</maxHistory>

</rollingPolicy>

<encoder>

<pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern>

</encoder>

</appender>

<root level="info">

<appender-ref ref="ROLLING"/>

</root>

</configuration>

示例：日志写入 logs/application.log ，并每天轮换，保留 7 天的历史记录。

4.Spring Boot日志记录的最佳实践

4.1 使用 SLF4J

始终使用 SLF4J API 进行日志记录。这确保了在不更改应用程序代码的情况下灵活切换底层框架。

示例：

import org.slf4j.Logger;

import org.slf4j.LoggerFactory;

public class DemoApplication {

private static final Logger logger = LoggerFactory.getLogger(DemoApplication.class);

public static void main(String[] args) {

logger.info("Application started");

}

}

4.2 在适当的级别记录日志

• ERROR ：用于严重问题。
• WARN : 对于可能需要关注的非关键问题。
• INFO : 用于一般运行时信息。
• DEBUG : 用于调试目的（请勿在生产环境中启用）。
• TRACE : 获取详细的跟踪级别信息。

4.3 避免记录敏感信息

不要记录敏感数据，如密码、 API 密钥或个人用户信息。

4.4 使用异步日志记录（可选）

对于高性能应用，考虑使用异步日志记录以减少开销。

Logback 中的配置：

<configuration>

<appender name="ASYNC" class="ch.qos.logback.classic.AsyncAppender">

<appender-ref ref="ROLLING"/>

</appender>

<root level="info">

<appender-ref ref="ASYNC"/>

</root>

</configuration>

5. 调试与故障排除

启用调试日志

要为所有包启用调试日志：

logging.level.root=DEBUG

要为特定包启用调试日志：

logging.level.com.example=DEBUG

启用跟踪日志

如需更详细的信息：

logging.level.com.example=TRACE

检查日志目录

确保在使用基于文件的日志记录时，应用程序对日志目录具有写权限。

结论

Spring Boot 中的日志记录既强大又灵活，能够满足广泛的应用需求。通过理解并利用各种日志模式和最佳实践，您可以增强应用程序的可观察性和可维护性。无论您是在构建简单的服务还是复杂的微服务架构，有效的日志记录始终是您进行故障排除和监控的第一道防线。

来源：
https://spring4all.com/forum-post/8425.html