###
Spring Boot 中
使用 Log4j2 实现单独输出日志的配置
要在
Spring Boot 项目中通过
Log4j2 实现单独的日志输出功能，需要完成以下几个方面的设置：
#### 1. 修改 `pom.xml` 文件
排除默认日志框架
Spring Boot 默认
使用的是
Logback 日志框架。为了切换到
Log4j2，需在项目的依赖中移除
Logback 和其他冲突项。
```xml
<dependency>
<groupId>org.
springframework.
boot</groupId>
<artifactId>
spring-
boot-starter-web</artifactId>
<!-- 移除
自带的
logback -->
<exclusions>
<exclusion>
<groupId>org.
springframework.
boot</groupId>
<artifactId>
spring-
boot-starter-
logging</artifactId>
</exclusion>
</exclusions>
</dependency>
<!-- 添加
Log4j2 相关依赖 -->
<dependency>
<groupId>org.apache.
logging.
log4j</groupId>
<artifactId>
log4j-core</artifactId>
</dependency>
<dependency>
<groupId>org.apache.
logging.
log4j</groupId>
<artifactId>
log4j-slf4j-impl</artifactId>
</dependency>
```
这里需要注意，`
log4j-slf4j-impl` 是用于桥接 SLF4J 和
Log4j2 的适配器[^1]。
---
#### 2. 创建
Log4j2 配置文件
创建名为 `
log4j2.xml` 或者 `
log4j2.yaml` 的配置文件，并将其放置于 `src/main/resources/` 下面。以下是基于 XML 格式的简单示例：
```xml
<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
<Properties>
<Property name="
LOG_PATTERN">%d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %-5level %
logger{36} - %msg%n</Property>
<Property name="
LOG_FILE">
logs/app.
log</Property>
</Properties>
<Appenders>
<!-- 控制台输出 -->
<Console name="Console" target="SYSTEM_OUT">
<PatternLayout pattern="${
LOG_PATTERN}" />
</Console>
<!-- 文件输出 -->
<RollingFile name="File"
fileName="${
LOG_FILE}"
filePattern="
logs/$${date:yyyy-MM}/app-%d{MM-dd-yyyy}-%i.
log.gz">
<PatternLayout>
<pattern>${
LOG_PATTERN}</pattern>
</PatternLayout>
<Policies>
<SizeBasedTriggeringPolicy size="10MB"/>
</Policies>
</RollingFile>
</Appenders>
<
Loggers>
<!-- Root
Logger -->
<Root level="info">
<AppenderRef ref="Console"/>
<AppenderRef ref="File"/>
</Root>
<!-- 单独定义某个类的日志输出 -->
<
Logger name="com.example.myclass" level="debug" additivity="false">
<AppenderRef ref="File"/>
</
Logger>
</
Loggers>
</Configuration>
```
上述配置实现了以下几点：
- 定义了一个控制台输出 (`Console`) 和滚动文件输出 (`RollingFile`)。
- 设置了根日志级别为 `INFO`，并通过 `<
Logger>` 节点指定特定包或类的日志行为[^4]。
---
#### 3. 指定配置文件路径 (可选)
如果希望自定义加载位置，则可以在 `application.properties` 或 `application.yml` 中声明如下属性：
```properties
# application.properties
logging.config=classpath:
log4j2.xml
```
或者 YAML 格式：
```yaml
# application.yml
logging:
config: classpath:
log4j2.xml
```
这一步确保
Spring Boot 正确读取并应用
Log4j2 的配置文件[^4]。
---
#### 4. 测试日志输出
编写测试代码验证日志是否按预期工作：
```java
package com.example;
import org.slf4j.
Logger;
import org.slf4j.
LoggerFactory;
import org.
springframework.stereotype.Component;
@Component
public class My
Logger {
private static final
Logger
logger =
LoggerFactory.get
Logger(My
Logger.class);
public void
logMessage() {
logger.debug("This is a debug message.");
logger.info("This is an info message.");
logger.warn("This is a warning message.");
logger.error("This is an error message.");
}
}
```
启动应用程序后，可以通过查看控制台和日志文件确认消息是否被正确记录。
---
#### 注意事项
- 如果需要每日生成一个新的日志文件，可以调整 `filePattern` 属性中的日期格式[^3]。
- 确保 `
log4j-slf4j-impl` 版本与
Spring Boot 及
Log4j2 的版本兼容[^1]。
---
###
本文讲解如何在SpringBoot项目中排除默认日志实现，以便融合自定义的日志系统。通过在pom.xml文件中配置排除spring-boot-starter-logging依赖，从而实现更精细的日志控制。
扫一扫
1036
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
