Log4j入门教程：轻松掌握Java日志记录

Log4j入门教程：轻松掌握Java日志记录

写于2025年9月

大家好！今天我想和大家分享一下Log4j这个强大却又不复杂的日志记录工具。作为一名开发者，我曾经也是对日志这块儿一知半解，直到真正需要调试复杂问题时才意识到：哇，没有好的日志系统简直寸步难行！

为什么需要日志？

先问个问题 – 你是不是还在用.out.()来调试代码？（我们都经历过这个阶段！）但在实际项目中，这种方式简直就是灾难：

这就是为什么我们需要Log4j这样的专业日志框架！

Log4j是什么？

Log4j（Log for Java）是软件基金会的一个开源项目log4j教程，它提供了强大而灵活的日志记录功能。说白了，它就是一个能让你轻松管理、控制和输出日志信息的Java库。

注意：本文讨论的是Log4j 2，这是目前最新最安全的版本。老版本Log4j 1.x已经不再维护，存在安全隐患！！！

为什么选择Log4j？开始使用Log4j

好了，废话不多说log4j教程，我们来看看怎么在项目中使用Log4j 2！

第一步：添加依赖

如果你使用Maven，在pom.xml中添加：

…-api2.20.0org…-core2.20.0

使用的朋友可以这样：

'org…log4j:log4j-api:2.20.0' 'org…log4j:log4j-core:2.20.0'

第二步：创建配置文件

Log4j需要一个配置文件来告诉它怎么处理日志。最简单的方式是在src/main/目录下创建一个.xml文件：

“`xml

“`

这个配置文件做了什么？它创建了两个”输出目标”（）：

一个输出到控制台一个输出到logs/app.log文件

两者使用的是不同的日志格式（）。

第三步：在代码中使用Log4j

好了，现在来实际写代码：

“` org…log4j.; org…log4j.;

class MyApp {// 创建实例 final = .(MyApp.class);

}“`

运行这个程序，你会看到控制台输出日志，同时在项目根目录下会创建一个logs/app.log文件。

日志级别详解

Log4j有六个主要的日志级别（从低到高）：

TRACE：最详细的信息，一般用于深度调试DEBUG：调试信息，开发时有用INFO：一般信息，程序正常运行时的状态信息WARN：警告信息，不影响使用，但最好关注ERROR：错误信息，程序遇到了问题FATAL：致命错误，导致程序中断

实际使用中，你可以设置一个”阈值”。比如设置为INFO级别，那么TRACE和DEBUG的日志就不会输出Log4j入门教程：轻松掌握Java日志记录，只有INFO及以上级别的日志才会记录。这样在开发和生产环境可以使用不同的设置！

配置文件详解

Log4j的配置文件是整个系统的核心。我们来分解一下它的主要部分：

（输出目标）

决定日志往哪里输出。常见的有：

（布局）

决定日志的格式。最常用的是，它使用一种类似的格式串：

（记录器）

决定哪些类的日志使用什么级别。你可以为不同的包设置不同的日志级别。比如：

xml

这样配置会让你自己的数据库相关代码输出DEBUG级别的日志，只输出WARN级别以上的日志，其他所有类输出INFO级别以上的日志。

实际应用案例

理论讲完了，我们来看几个实际应用场景！

场景1：按日期滚动的日志文件

想让你的日志每天自动创建一个新文件？这样配置：

xml

这样设置后Log4j入门教程：轻松掌握Java日志记录，日志文件会每天或者达到10MB时滚动一次，并且最多保留20个历史文件。

场景2：按不同服务分离日志

在微服务架构中，可能需要将不同服务的日志分开：

xml

场景3：异步日志提升性能

在高并发系统中，同步写日志可能成为性能瓶颈。使用异步方式可以显著提升性能：

“`xml

“`

进阶技巧

掌握了基础后，我们来看一些进阶用法！

1. 使用标记特殊日志

可以用来给日志加上特殊标记，便于过滤：

“` org…log4j.; org…log4j.; org…log4j.; org…log4j.;

class { final = .(.class); final = .(“”);

}“`

然后在配置中，你可以专门为这些标记了的日志指定特殊处理：

xml

2. 使用MDC传递上下文信息

MDC（ ）允许你把一些上下文信息（比如用户ID、请求ID）关联到日志中：

“` org…log4j.; org…log4j.; org…log4j.; // MDC在中叫

class { final = .(.class);

}“`

然后在中使用这些值：

xml

日志会显示成这样：10:15:23.456

http-nio-8080-exec-1

INFO com.myapp.

reqId: user:

– 开始处理请求

3. 自定义Log4j的日志级别

如果默认的日志级别不够用，你还可以定义自己的级别：

“` org…log4j.Level; org…log4j.; org…log4j.; org…log4j.core..;

class {// 定义自己的级别，介于INFO和WARN之间 final Level = Level.(“”, 350);

}“`

常见问题与解决方案问题1：日志配置文件不生效

检查：- 配置文件是否放在正确的位置（通常是根目录）- 文件名是否正确（.xml、.json、.等）- XML语法是否有误

问题2：性能优化

“`java// 不好的写法 – 即使日志级别设置为ERRORlog4j教程，仍会进行字符串拼接.debug(“User data: ” + tring(user));

// 好的写法 – 使用参数占位符.debug(“User data: {}”, tring(user));

// 更好的写法 – 使用延迟计算.debug(“User data: {}”, () -> tring(user));“`

问题3：日志文件权限

在Linux系统中，如果日志文件创建失败，可能是权限问题。确保应用有写入日志目录的权限。

总结