Log4j2需引入log4j-api和log4j-core两个Maven依赖，配置文件默认为log4j2.xml并置于src/main/resources下，核心由Logger、Appender、Layout三要素构成，日志级别从低到高为ALL/TRACE/DEBUG/INFO/WARN/ERROR/FATAL/OFF。
Log4j 是 Java 项目中最常用、最成熟的日志框架之一，安装简单、配置灵活，不改代码就能控制日志输出行为。掌握基础安装和核心配置，是每个 Java 开发者日常开发的必备技能。
引入 Log4j 依赖
Log4j 2.x 需同时引入 API 和实现模块，推荐使用 Maven 管理依赖：
- log4j-api：提供日志接口（Logger、Level 等）
- log4j-core：提供具体实现（Appender、Layout、异步支持等）
在 pom.xml 中添加：
<dependency> <groupId>org.apache.logging.log4j</groupId> <artifactId>log4j-api</artifactId> <version>2.20.0</version> </dependency> <dependency> <groupId>org.apache.logging.log4j</groupId> <artifactId>log4j-core</artifactId> <version>2.20.0</version> </dependency>
注意：避免混用旧版 log4j 1.x（已停止维护且存在严重安全漏洞），务必使用 2.x 最新稳定版。
立即学习“Java免费学习笔记（深入）”；
配置文件放在正确位置
Log4j 2 默认自动加载 classpath 下的配置文件，优先级从高到低为：
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- log4j2-test.xml（测试环境）
- log4j2.xml（生产推荐）
- log4j2.json / log4j2.yaml（可选格式）
- log4j2.properties（兼容性好，但功能略受限）
文件必须放在 src/main/resources/ 目录下，否则无法识别。常见错误是放错路径或命名不规范（如写成 log4j.xml 或 log4j2.conf）。
三要素配置：Logger、Appender、Layout
所有配置都围绕这三个核心组件展开：
-
Logger：按类或包名定义日志入口，例如
LogManager.getLogger(OrderService.class) - Appender：指定日志输出目标，如控制台（Console）、文件（File）、滚动文件（RollingFile）
-
Layout：定义日志格式，常用 PatternLayout，支持占位符如
%d{HH:mm:ss}、%level、%c{1}、%msg
一个最小可用的 log4j2.xml 示例：
<Configuration status="WARN">
<Appenders>
<Console name="Console" target="SYSTEM_OUT">
<PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %c{1} - %msg%n"/>
</Console>
</Appenders>
<Loggers>
<Root level="info">
<AppenderRef ref="Console"/>
</Root>
</Loggers>
</Configuration>日志级别与分级控制
Log4j 支持七种标准级别（从低到高）：ALL → TRACE → DEBUG → INFO → WARN → ERROR → FATAL → OFF。实际项目中常用：
- DEBUG：仅开发/测试启用，记录详细流程，如参数值、分支判断
- INFO：关键业务节点，如“订单创建成功”“用户登录完成”
- WARN：潜在问题但不影响主流程，如降级调用、配置缺失
-
ERROR：异常发生且需人工介入，必须带异常堆栈（
logger.error("xxx", e)）
可通过配置动态调整级别，例如将某个模块设为 DEBUG 而整体保持 INFO：
<Logger name="com.example.service" level="debug" additivity="false"> <AppenderRef ref="Console"/> </Logger>
配置不是越复杂越好，先跑通控制台输出，再逐步加文件、滚动、异步等能力。关键是理解三要素之间的关系，而不是死记模板。
