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，避免输出太多内部信息。
是输出到控制台的 Appender， 是写入文件的 Appender。 - 日志格式由 PatternLayout 定义，常用的格式符有 %d（时间）、%level（日志级别）、%logger（类名）、%msg（日志内容）等。
- 标签设置全局日志级别，也可以为特定包设置不同级别。
如果想按天生成日志文件，可以换成
在代码中怎么使用？
引入依赖并配置好 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 就能很好地为你服务。
