log4j.xml是什么 如何用它来配置Log4j日志系统

阿瑶酱_4890

阿瑶酱_4890

2026-01-18

1208人浏览

原创

log4j.xml 是 Log4j 1.x 的 XML 配置文件,需置于 classpath 根目录,用于定义日志级别、Appender 和 Layout;它已被 Log4j 2.x 弃用,且存在严重安全漏洞,存量系统应尽快升级。

log4j.xml是什么 如何用它来配置log4j日志系统

log4j.xml 是 Log4j 1.x 版本使用的 XML 格式配置文件,用于声明式定义日志输出级别、Appender(输出目标)、Layout(格式)等行为。Log4j 2.x 已弃用该文件名和格式,改用 log4j2.xml;若项目中看到 log4j.xml,基本可判定使用的是 Log4j 1.2.x —— 这个版本早已停止维护,且存在严重安全风险(如 CVE-2017-5645、CVE-2021-4104),**不建议新项目使用,存量系统应尽快升级或迁移**。

log4j.xml 的加载机制与位置要求

Log4j 1.x 在启动时会按固定顺序查找配置文件:log4j.xml 优先于 log4j.properties。它必须位于类路径(classpath)根目录下(如 src/main/resources/ 或 WEB-INF/classes/),否则 Log4j 会回退到默认控制台输出,且不报错 —— 这是常见静默失效原因。

  • 文件名必须严格为 log4j.xml,大小写敏感(Windows 下可能不报错,Linux 下常失败)
  • 不能放在子目录(如 config/log4j.xml),除非手动调用 DOMConfigurator.configure("config/log4j.xml")
  • 若同时存在 log4j.xml 和 log4j.properties,前者生效,后者被忽略

一个最小可用的 log4j.xml 示例

以下配置将日志输出到控制台,并设置根日志器级别为 INFO:

<?xml version="1.0" encoding="UTF-8"?><configuration xmlns:log4j="http://jakarta.apache.org/log4j/"><p><appender name="console" class="org.apache.log4j.ConsoleAppender"><layout class="org.apache.log4j.PatternLayout"><param name="ConversionPattern" value="%d{yyyy-MM-dd HH:mm:ss} [%t] %-5p %c{1} - %m%n"></layout></appender></p>
<p><root><priority value="info"></priority><appender-ref ref="console"></appender-ref></root></p>
<p></p><div class="aritcle_card flexRow artxards">
											<div class="artcardd flexRow">
												<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill10918" title="Linux Security Scanner"><img
														src="https://img.php.cn/upload/skill/001/246/273/6adaf20cf0281539.jpg" alt="Linux Security Scanner" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
												<div class="aritcle_card_info flexColumn">
													<a rel="nofollow" href="/xiazai/skill10918" title="Linux Security Scanner" class="overflowclass">Linux Security Scanner</a>
													<p class="overflowclass">Linux 安全审计工具,检查 SSH 配置、开放/监听端口、防火墙规则(ufw/iptables/nftables)、失败登录尝试、sudoers 权限...</p>
												</div>
												<a rel="nofollow" href="/xiazai/skill10918" title="Linux Security Scanner" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
												</a>
											</div>
										</div></configuration>

注意点:

  • DOCTYPE 声明中的 log4j.dtd 不需要本地存在,Log4j 会从 jar 包内加载;若网络受限或校验失败,可删掉整行 DOCTYPE(Log4j 1.2.17+ 支持无 DTD 解析)
  • class 属性值必须是完整类名,拼写错误(如少个 o 写成 ConsolAppender)会导致启动时报 ClassNotFoundException,但日志可能被吞掉
  • ConversionPattern 中的 %c{1} 表示只打印 logger 名的最末一段(如 com.example.Service → Service),%c 则全量输出

log4j.xml 中常见的 Appender 配置差异

不同 Appender 类决定日志落地方式,参数含义差异大:

  • FileAppender:需显式设 File 参数(如 /var/log/app.log),Append 设为 true 才追加写入,默认 false 每次覆盖
  • DailyRollingFileAppender:支持按天滚动,关键参数是 DatePattern(如 '.'yyyy-MM-dd),但不支持压缩归档 —— 需配合外部脚本清理
  • RollingFileAppender:靠 MaxFileSize + MaxBackupIndex 控制单文件大小和备份数,比 Daily 更可控,但不按时间切分
  • SocketAppender:发日志到远程 log4j-server,需确保服务端已启动且防火墙放行端口,否则应用启动会卡住(默认阻塞连接)

所有 Appender 若未关联到某个 logger(包括 root),就完全不会生效 —— 这是配置后看不到日志的最常见疏漏。

Log4j 1.x 的 XML 配置没有命名空间校验、无类型提示、错误反馈弱,加上 DTD 加载不稳定,实际维护成本远高于 log4j.properties。如果只是想快速启用日志,直接写 properties 文件更可靠;如果必须用 XML,务必用 IDE 的 XML Schema 支持(如绑定 log4j.dtd)来避免标签闭合或属性名拼写错误。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.01

4924

5

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

2024.08.01

6397

7

xml是什么格式的文件
xml是什么格式的文件

xml是一种纯文本格式的文件。xml指的是可扩展标记语言,标准通用标记语言的子集,是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容,可阅读本专题下面的相关文章。

2024.11.28

2582

7

pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.01

4924

5

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

2024.08.01

6397

7

xml是什么格式的文件
xml是什么格式的文件

xml是一种纯文本格式的文件。xml指的是可扩展标记语言,标准通用标记语言的子集,是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容,可阅读本专题下面的相关文章。

2024.11.28

2582

7

class在c语言中的意思
class在c语言中的意思

在C语言中,"class" 是一个关键字,用于定义一个类。想了解更多class的相关内容,可以阅读本专题下面的文章。

2024.01.03

4356

7

python中class的含义
python中class的含义

本专题整合了python中class的相关内容,阅读专题下面的文章了解更多详细内容。

2025.12.06

306

9

append用法
append用法

append是一个常用的命令行工具,用于将一个文件的内容追加到另一个文件的末尾。想了解更多append用法相关内容,可以阅读本专题下面的文章。

2023.10.25

618

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习