Log4j 2 / SLF4J 用于 Java：完整指南与示例

这是什么库以及为什么需要它

Log4j 2 和 SLF4J 是两个相互关联的 Java 日志记录库，是企业级开发领域的事实标准。 SLF4J（Simple Logging Facade for Java） 是一个门面（抽象层），为各种日志记录框架提供统一的 API。 Log4j 2 是该 API 最强大、性能最高的实现之一。

为什么需要它？ 日志记录是记录应用程序运行信息的过程：错误、警告、信息性消息、调试信息。没有日志记录系统，开发人员被迫使用 System.out.println()，这会导致：

• 无法灵活管理输出（为应用程序的不同部分启用/禁用日志）
• 缺少日志级别（INFO、WARN、ERROR、DEBUG）
• 性能问题（即使日志被禁用，也会进行字符串拼接）
• 缺少输出格式（日期、时间、类名、线程）

Log4j 2 解决了所有这些问题。它支持异步日志记录、过滤器、附加器（输出到文件、控制台、数据库、网络）、日志轮转以及许多其他高级功能。SLF4J 允许在必要时无需更改代码即可从 Log4j 2 切换到 Logback 或 java.util.logging。

安装

对于 Java 项目，通过 Maven 或 Gradle 构建系统进行安装。与 Python（pip）或 Node.js（npm）不同，Java 通过配置文件管理依赖关系。

Maven (pom.xml)

<!-- SLF4J API + Log4j 2 作为实现 --><dependency>    <groupId>org.apache.logging.log4j</groupId>    <artifactId>log4j-slf4j-impl</artifactId>    <version>2.20.0</version></dependency>

<!-- Log4j 2 核心 API（如果不使用 SLF4J） --><dependency>    <groupId>org.apache.logging.log4j</groupId>    <artifactId>log4j-core</artifactId>    <version>2.20.0</version></dependency>

Gradle (build.gradle)

dependencies {    implementation 'org.apache.logging.log4j:log4j-slf4j-impl:2.20.0'    implementation 'org.apache.logging.log4j:log4j-core:2.20.0'}

添加依赖项后，在 src/main/resources 文件夹中创建配置文件 log4j2.xml：

<?xml version="1.0" encoding="UTF-8"?><Configuration status="WARN">    <Appenders>        <Console name="Console" target="SYSTEM_OUT">            <PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>        </Console>    </Appenders>    <Loggers>        <Root level="info">            <AppenderRef ref="Console"/>        </Root>    </Loggers></Configuration>

快速入门与代码示例

创建一个简单的 Java 类进行演示：

import org.slf4j.Logger;import org.slf4j.LoggerFactory;

public class QuickStart {    // 为当前类创建日志记录器    private static final Logger logger = LoggerFactory.getLogger(QuickStart.class);

    public static void main(String[] args) {        logger.info("应用程序已启动");        logger.debug("这是一条调试消息");        logger.warn("警告：资源即将耗尽");        logger.error("严重错误：{}", "除以零");

        try {            int result = 10 / 0;        } catch (ArithmeticException e) {            logger.error("计算时出错", e);        }    }}

控制台输出将如下所示：

14:30:15.123 [main] INFO  QuickStart - 应用程序已启动14:30:15.125 [main] WARN  Q