Log4j 详解：Java经典日志框架

Ne0inhk

— 11 min read
Log4j 详解：Java经典日志框架

在 Java 开发中，日志是排查问题、监控程序运行状态的核心手段。相比于System.out.println，专业的日志框架能提供更灵活的配置、更优的性能和更丰富的功能。本文将全面讲解 Log4j 的核心概念、配置方式及实战技巧，帮助你快速掌握并落地到项目中。

一、日志框架概述

1.1 什么是日志

日志是程序运行过程中产生的事件记录，典型场景包括：

  • 业务流程节点：如 “用户 ID=123 提交订单，订单号 = 456”；
  • 异常详情：捕获异常时记录完整堆栈信息（替代e.printStackTrace()）；
  • 关键参数 / 结果：如接口入参、返回值；
  • 系统状态：如 JVM 内存使用、数据库连接池状态。

1.2 为什么要打印日志？

调试器断点仅适用于开发阶段，且可能因断点导致多线程问题 “隐藏”；而日志能持久化记录程序运行轨迹，是线上问题排查、生产环境监控的核心依据。

1.3 为什么需要日志框架？

对比System.out.println，Log4j 的优势一目了然：

对比维度System.out.printlnLog4j（日志框架）
性能同步阻塞，高并发下影响性能支持异步输出，性能更优
目的地只能控制台，无法持久化支持控制台、文件、数据库、消息队列等多目的地
格式定制只有文字，无时间、线程、类名、行号自带时间、线程、类、方法、行号等结构化信息
持久化无法自动持久化，需手动处理自动按文件大小 / 时间分割、归档日志
维护性生产环境需手动删除，易遗漏配置控制开关，无需修改代码
级别控制无级别区分，所有信息强制输出可按级别过滤，生产 / 测试环境灵活切换

1.4 常见 Java 日志框架

  • Log4j：Apache 开源经典框架，应用广泛；
  • Logback：Log4j 升级版，性能更优，原生支持 SLF4J；
  • JUL（java.util.logging）：JDK 自带，功能简陋；
  • SLF4J：日志门面（接口），统一 API，可切换底层实现（Log4j/Logback 等）。

1.5 Log4j 的优势

  • 配置灵活：支持 XML/Properties 等配置方式，无需改代码即可调整输出；
  • 功能强大：多输出目的地、日志分级、自定义格式；
  • 轻量级：依赖少，占用资源小；
  • 社区成熟：文档丰富，问题解决方案多。

二、Log4j 核心概念

Log4j 的核心由三大组件协同工作，完成日志的采集、输出和格式化：

2.1 Logger（日志记录器）

  • 作用：负责采集日志信息，是程序中直接使用的接口；
  • 命名规则：通常以当前类的全限定名命名（如com.example.demo.UserService），便于定位日志来源；
  • 层级关系：存在父子关系，根 Logger 为rootLogger（所有 Logger 的父类），子 Logger 继承父类配置；
  • 获取方式：Logger logger = Logger.getLogger(当前类.class);。

2.2 Appender（输出目的地）

  • 作用：定义日志输出位置，一个 Logger 可绑定多个 Appender（日志同时输出到多个地方）；
  • 常见实现类：
    • ConsoleAppender：输出到控制台；
    • FileAppender：输出到文件；
    • RollingFileAppender：按文件大小分割日志（滚动日志）；
    • DailyRollingFileAppender：按时间分割日志；
    • JDBCAppender：输出到数据库。

2.3 Layout（日志格式器）

  • 作用：定义日志输出格式（时间、级别、类名、内容等）；
  • 常见实现类：
    • PatternLayout：自定义日志模板（最常用）；
    • SimpleLayout：仅包含级别和日志信息；
    • HTMLLayout：HTML 格式，适合浏览器查看。

2.4 日志级别（优先级从高到低）

核心规则：只输出级别≥当前 Logger 设置级别的日志。

级别说明
FATAL致命错误，程序无法运行（如数据库连接失败、核心配置缺失）
ERROR错误信息，单个异常（如接口调用失败），不影响整体流程
WARN警告信息，状态异常但不报错（如参数不合法、缓存过期）
INFO普通信息，记录正常运行轨迹（如程序启动、接口调用成功）
DEBUG调试信息，开发阶段定位问题（如变量值、方法执行步骤）
TRACE追踪信息，比 DEBUG 更详细，记录代码每一步执行（较少使用）

示例：Logger 设置为 INFO 级别，仅输出 INFO/WARN/ERROR/FATAL 级别的日志。

三、Log4j 环境搭建

3.1 依赖引入（Maven）

Log4j 1.x 核心依赖：

xml

<dependency> <groupId>log4j</groupId> <artifactId>log4j</artifactId> <version>1.2.17</version> </dependency>

3.2 默认日志输出

若未添加配置文件（log4j.properties/log4j.xml），Log4j 启用默认配置：

  • 级别：仅输出 ERROR/FATAL；
  • 目的地：仅控制台；
  • 格式：简单格式（级别 + 日志内容）。

示例代码：

java

import org.apache.log4j.Logger; public class Log4jDefaultDemo { private static final Logger logger = Logger.getLogger(Log4jDefaultDemo.class); public static void main(String[] args) { logger.debug("调试信息：无配置文件时不输出"); logger.info("普通信息：无配置文件时不输出"); logger.error("错误信息：无配置文件时会输出"); logger.fatal("致命信息：无配置文件时会输出"); } }

运行结果：

ERROR - 错误信息：无配置文件时会输出 FATAL - 致命信息：无配置文件时会输出

3.3 手动控制日志格式（无配置文件）

若需临时自定义格式，可通过代码构建 Layout 和 Appender：

java

import org.apache.log4j.ConsoleAppender; import org.apache.log4j.Level; import org.apache.log4j.Logger; import org.apache.log4j.PatternLayout; public class Log4jNoConfigTest { private static final Logger logger = Logger.getLogger(Log4jNoConfigTest.class); public static void main(String[] args) { // 自定义格式：时间 [级别] 类名 - 日志内容 PatternLayout layout = new PatternLayout("%d{yyyy-MM-dd HH:mm:ss} [%5p] %c{1} - %m%n"); ConsoleAppender consoleAppender = new ConsoleAppender(layout); logger.addAppender(consoleAppender); logger.setLevel(Level.WARN); // 输出WARN及以上 logger.warn("警告信息：自定义格式输出"); logger.error("错误信息：自定义格式输出"); } }

四、Log4j 配置详解

配置文件是 Log4j 的核心，支持 Properties 和 XML 格式，启动时优先加载classpath下的log4j.xml，其次是log4j.properties。

4.1 Properties 格式配置（入门首选）

4.1.1 配置根 Logger

格式：log4j.rootLogger=日志级别, Appender1, Appender2,...示例：

properties

# 根Logger级别为DEBUG，绑定控制台+文件输出 log4j.rootLogger=DEBUG, CONSOLE, FILE
4.1.2 配置 ConsoleAppender（控制台输出）

properties

log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout # 自定义格式：时间 [级别] 类名 - 内容 log4j.appender.CONSOLE.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} [%p] %c{1} - %m%n
4.1.3 配置 RollingFileAppender（按大小分割日志）

properties

log4j.appender.FILE=org.apache.log4j.RollingFileAppender log4j.appender.FILE.File=logs/demo.log # 日志路径 log4j.appender.FILE.MaxFileSize=10MB # 单文件最大大小 log4j.appender.FILE.MaxBackupIndex=10 # 最大备份数 log4j.appender.FILE.layout=org.apache.log4j.PatternLayout log4j.appender.FILE.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} [%p] %l - %m%n
4.1.4 配置 DailyRollingFileAppender（按时间分割）

properties

log4j.appender.DAILY_FILE=org.apache.log4j.DailyRollingFileAppender log4j.appender.DAILY_FILE.File=logs/daily_demo.log log4j.appender.DAILY_FILE.DatePattern='.'yyyy-MM-dd # 按天分割 log4j.appender.DAILY_FILE.layout=org.apache.log4j.PatternLayout log4j.appender.DAILY_FILE.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} [%p] %c - %m%n
4.1.5 常用 PatternLayout 转换符
转换符说明
%d日志时间（自定义格式）
%p日志级别
%cLogger 名称（类全限定名）
%c{1}仅显示类名（省略包名）
%l日志位置（类 + 方法 + 行号）
%m日志内容
%n换行符
%t当前线程名称
4.1.6 自定义 Logger（按包 / 类配置）

对指定包 / 类单独配置日志级别，避免全局配置冲突：

properties

# com.example.demo包下日志级别为INFO，仅输出到文件 log4j.logger.com.example.demo=INFO, FILE # 禁止继承根Logger的Appender（避免重复输出） log4j.additivity.com.example.demo=false

4.2 XML 格式配置（复杂场景）

结构清晰，支持高级功能，示例如下：

xml

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE log4j:configuration SYSTEM "log4j.dtd"> <log4j:configuration> <!-- 控制台Appender --> <appender name="CONSOLE"> <layout> <param name="ConversionPattern" value="%d{yyyy-MM-dd HH:mm:ss} [%p] %c{1} - %m%n"/> </layout> </appender> <!-- 滚动文件Appender --> <appender name="FILE"> <param name="File" value="D:/logs/demo.log"/> <param name="MaxFileSize" value="5MB"/> <param name="MaxBackupIndex" value="5"/> <layout> <param name="ConversionPattern" value="%d{yyyy-MM-dd HH:mm:ss} [%p] %l - %m%n"/> </layout> </appender> <!-- 自定义Logger --> <logger name="com.example.demo" additivity="false"> <level value="INFO"/> <appender-ref ref="FILE"/> </logger> <!-- 根Logger --> <root> <level value="DEBUG"/> <appender-ref ref="CONSOLE"/> <appender-ref ref="FILE"/> </root> </log4j:configuration>

4.3 Properties vs XML 对比

对比维度Properties 格式XML 格式
语法复杂度简单（键值对）较复杂（标签）
可读性简单配置清晰复杂配置清晰
功能支持基础功能高级功能（条件判断等）
适用场景小型项目 / 入门中大型项目

五、SLF4J + Log4j 整合（注解版）

SLF4J 是日志门面，统一 API，配合 Lombok 的@Slf4j可简化 Logger 创建。

5.1 引入依赖

xml

<!-- SLF4J桥接Log4j --> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-log4j12</artifactId> <version>1.7.36</version> </dependency> <!-- Lombok（简化Logger创建） --> <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <version>1.18.30</version> <scope>provided</scope> </dependency>

5.2 使用示例

java

import lombok.extern.slf4j.Slf4j; @Slf4j // 自动生成log实例，无需手动创建 public class Slf4jTest { public static void main(String[] args) { // 占位符输出（避免字符串拼接） String username = "zhangsan"; log.info("用户{}登录成功", username); // 记录异常 try { int result = 20 / 0; } catch (Exception e) { log.error("算术异常", e); // 自动打印堆栈 } } }

5.3 优势

  • 简化代码：无需手动写Logger.getLogger(类.class)；
  • API 统一：切换底层框架（如 Logback）无需改业务代码；
  • 性能优化：占位符避免无效字符串拼接。

六、常见问题与注意事项

6.1 问题 1：警告 “Could not find log4j.properties or log4j.xml”

原因：配置文件未放在classpath下（Maven 项目需放在src/main/resources）。

6.2 问题 2：日志无法输出到文件

  • 路径错误：检查File配置的绝对 / 相对路径；
  • 权限不足：目标目录无写入权限；
  • 级别过高：如 Logger 级别为 INFO，DEBUG 日志不会输出。

6.3 问题 3：日志重复输出

原因：自定义 Logger 的additivity为 true（默认），日志同时输出到自定义和根 Logger 的 Appender；解决方案：log4j.additivity.包名=false。

6.4 注意事项

  • 生产环境禁用 DEBUG/TRACE：减少日志量，提升性能；
  • 避免字符串拼接：使用占位符（%s/%d）；
  • 敏感信息不记录：日志中屏蔽密码、手机号等；
  • 定期清理日志：使用滚动日志避免文件过大。

七、实战案例

7.1 基础案例（控制台 + 文件输出）

步骤 1：配置 log4j.properties

properties

log4j.rootLogger=DEBUG, CONSOLE, FILE # 控制台配置 log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout log4j.appender.CONSOLE.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} [%p] %c{1} - %m%n # 文件配置 log4j.appender.FILE=org.apache.log4j.RollingFileAppender log4j.appender.FILE.File=D:/logs/demo.log log4j.appender.FILE.MaxFileSize=5MB log4j.appender.FILE.MaxBackupIndex=5 log4j.appender.FILE.layout=org.apache.log4j.PatternLayout log4j.appender.FILE.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} [%p] %l - %m%n
步骤 2：编写业务代码

java

import org.apache.log4j.Logger; public class Log4jDemo { private static final Logger logger = Logger.getLogger(Log4jDemo.class); public static void main(String[] args) { logger.info("程序启动完成"); logger.debug("用户ID=123，查询订单"); try { int result = 10 / 0; } catch (Exception e) { logger.error("计算异常", e); } } }

7.2 进阶案例（按包配置级别）

需求：com.example.demo.service包下仅输出 INFO 及以上级别：

properties

log4j.rootLogger=DEBUG, CONSOLE log4j.logger.com.example.demo.service=INFO # 单独配置级别

测试代码：

java

package com.example.demo.service; import org.apache.log4j.Logger; public class UserService { private static final Logger logger = Logger.getLogger(UserService.class); public void login(String username) { logger.debug("验证用户名密码"); // 被过滤 logger.info("用户{}尝试登录", username); // 输出 } }

Read more

【初阶数据结构与算法】链表刷题之移除链表元素、反转链表、找中间节点、合并有序链表、链表的回文结构

【初阶数据结构与算法】链表刷题之移除链表元素、反转链表、找中间节点、合并有序链表、链表的回文结构

文章目录 * 一、移除链表元素 * 思路一 * 思路二 * 二、合并两个有序链表 * 思路： * 优化： * 三、反转链表 * 思路一 * 思路二 * 四、链表的中间节点 * 思路一 * 思路二 * 五、综合应用之链表的回文结构 * 思路一： * 思路二： 一、移除链表元素 题目链接：https://leetcode.cn/problems/remove-linked-list-elements/ 我们先来看看题目描述和第一个示例： 根据题目描述我们就可以大致明白题意，就是将一个链表中的某个值的节点删除，然后返回新链表的头结点，然后题目要我们实现的函数给了我们头结点，以及要删除的数据，我们要把相应的节点删除 思路一 首先最简单的思路就是，我们可以通过之前实现的链表的方法用上，首先使用Find方法找到对应的值，然后使用Erase方法删除，直到Find方法返回空指针结束 由于这个方法思路比较好实现，这里就不再赘述了，可以自己尝试一下，我们的关键是更优方法的思路二 思路二 这个题其实跟

By Ne0inhk
数据结构 | 队列：从概念到实战

数据结构 | 队列：从概念到实战

个人主页-爱因斯晨 文章专栏-数据结构 继续加油！ 文章目录 * 个人主页-爱因斯晨 * 文章专栏-数据结构 * 一、队列的基本概念 * 二、队列的核心操作 * 三、C 语言实现队列 * 3.1 顺序队列（数组实现） * 3.2 链式队列（链表实现） * 四、队列的应用场景 * 五、两种实现的对比选择 一、队列的基本概念 队列是一种先进先出（FIFO，First In First Out） 的线性数据结构，仅允许在一端进行插入操作（队尾），另一端进行删除操作（队头）。 生活中的队列场景： * 银行窗口排队办理业务 * 打印机任务队列 * 消息队列中的消息传递 二、队列的核心操作 1. 初始化（InitQueue）：创建一个空队列 2. 入队（

By Ne0inhk

SHA-256 哈希破解工具技术解析

一、程序功能概述 一个针对 SHA-256 哈希值的密码破解工具，其核心功能是通过多种密码攻击技术，将给定的 SHA-256 哈希值反向还原为原始明文密码。该工具集成了字典攻击、模式攻击、暴力破解等多种方法，通过组合不同的攻击策略提高哈希破解的成功率，适用于安全测试、密码审计等场景（需在合法授权范围内使用）。 程序的核心目标是：接收包含多个 SHA-256 哈希值的文件（默认1.txt），通过内置的密码生成与验证逻辑，找到哈希值对应的原始密码，并将结果保存到输出文件（默认2.txt）。其功能覆盖了从数据加载、密码生成、哈希比对到结果保存的完整流程，同时包含进度跟踪与状态提示，提升用户对破解过程的感知。 二、核心数据结构解析 程序通过HashCracker类封装所有功能，类内定义了多个关键数据结构，用于存储状态、配置与结果，这些结构的设计直接影响破解效率与功能完整性。 1. 实例属性设计 属性名类型作用设计逻辑found_passwords字典（dict）存储已破解的哈希值与对应密码，键为哈希值，值为明文密码字典的键值对结构支持 O (1) 时间复杂度的哈希值查找，

By Ne0inhk
数据结构：链表进阶

数据结构：链表进阶

链表进阶 * 1. ArrayList的缺陷 * 2. 链表 * 2.1 链表的概念及结构 * 2.2 链表的实现 * 3.链表面试题 * 4.LinkedList的使用 * 5.1 什么是LinkedList * 4.2 LinkedList的使用 * 5. ArrayList和LinkedList的区别 1. ArrayList的缺陷 通过源码知道，ArrayList底层使用数组来存储元素： publicclassArrayList<E>extendsAbstractList<E>implementsList<E>,RandomAccess,Cloneable,java.io.Serializable{// ...// 默认容量是10privatestaticfinalint DEFAULT_CAPACITY =10;//...// 数组：用来存储元素transientObject[

By Ne0inhk