log4j2 是一个高性能、可扩展的日志框架，适用于企业级 java 应用。1. 它具备异步日志提升性能、支持自定义格式、多种 appender 输出方式、配置热更新等优势；2. 引入 log4j2 需添加 log4j-core、log4j-api 和 log4j-slf4j2-impl 依赖；3. 配置文件 log4j2.xml 放在 resources 目录，通过 appenders 和 loggers 设置输出方式和日志级别；4. 在代码中使用 slf4j 的 logger 进行日志记录，并合理使用日志级别和占位符格式；5. 部署时注意日志路径唯一性、关闭 debug 日志、指定配置文件位置以适应多环境。
在Java项目中，日志管理是调试、监控和维护系统的重要手段。Log4j2 是 Apache 提供的一个高性能日志框架，广泛用于企业级应用中。它不仅支持多种日志输出方式，还能灵活配置日志级别、格式和输出路径。
为什么选择 Log4j2？
Log4j2 相比早期的日志工具（如 Log4j 1.x 和 java.util.logging）性能更好，并且具备自动重新加载配置、插件式架构等特性。如果你的项目需要稳定、高效、可扩展的日志系统，Log4j2 是一个非常合适的选择。
常见优势包括：
立即学习“Java免费学习笔记（深入）”；
- 异步日志大幅提升性能
- 支持自定义日志格式
- 多种 Appender（输出目标），比如控制台、文件、数据库等
- 配置热更新，无需重启服务即可生效
如何引入 Log4j2？
使用 Log4j2 前，首先要把它加入项目依赖中。如果你用的是 Maven 构建工具，在 pom.xml 中添加以下依赖：
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-core</artifactId>
<version>2.17.1</version>
</dependency>
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-api</artifactId>
<version>2.17.1</version>
</dependency>同时建议加上 SLF4J 的桥接器，方便以后切换日志实现：
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-slf4j2-impl</artifactId>
<version>2.17.1</version>
</dependency>怎么配置 log4j2.xml 文件？
Log4j2 的核心配置文件通常是 log4j2.xml，放在项目的 resources 目录下。下面是一个基础配置示例：
<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
<Appenders>
<!-- 控制台输出 -->
<Console name="Console" target="SYSTEM_OUT">
<PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss} [%t] %-5level %logger{36} - %msg%n"/>
</Console>
<!-- 文件输出 -->
<File name="File" fileName="logs/app.log">
<PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss} %-5level %logger{36} - %msg%n"/>
</File>
</Appenders>
<Loggers>
<!-- 设置根日志级别 -->
<Root level="info">
<AppenderRef ref="Console"/>
<AppenderRef ref="File"/>
</Root>
</Loggers>
</Configuration>几点说明：
-
status="WARN"表示 Log4j2 自身的日志级别为 WARN，避免输出太多内部信息。 -
<Console>是输出到控制台的 Appender，<File>是写入文件的 Appender。 - 日志格式由
PatternLayout定义，常用的格式符有%d（时间）、%level（日志级别）、%logger（类名）、%msg（日志内容）等。 -
<Root>标签设置全局日志级别，也可以为特定包设置不同级别。
如果想按天生成日志文件，可以换成 <RollingFile> Appender 并配置策略，例如每天滚动一次、保留一段时间的历史日志等。
在代码中怎么使用？
引入依赖并配置好 XML 后，就可以在 Java 类中使用日志了。通常配合 SLF4J 使用，代码如下：
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
public class MyService {
private static final Logger logger = LoggerFactory.getLogger(MyService.class);
public void doSomething() {
logger.info("开始执行操作");
try {
// 业务逻辑
} catch (Exception e) {
logger.error("发生异常", e);
}
}
}注意几点：
- 日志级别要合理使用：debug 适合开发调试，info 用于正常流程，warn 和 error 用于问题记录。
- 不要直接拼接字符串，比如
logger.info("用户ID：" + userId)，应使用占位符形式logger.info("用户ID：{}", userId)，更高效也更规范。 - 异常日志一定要带上异常对象，这样能打印堆栈信息，便于排查。
最后几句细节提醒
- 如果部署多个实例，确保日志文件路径是唯一的，或者不写本地文件，而是发送到统一日志平台（如 ELK）。
- 生产环境一般关闭 debug 级别日志，防止产生过多数据影响性能。
- 可以通过 JVM 参数
-Dlog4j.configurationFile=path/to/log4j2.xml指定配置文件位置，方便多环境切换。
基本上就这些，不复杂但容易忽略的地方在于配置文件的格式是否正确、日志级别是否合理设置，以及是否真正输出了有用的信息。只要把这几个点理清楚，Log4j2 就能很好地为你服务。
