0

0

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

畫卷琴夢

畫卷琴夢

发布时间:2026-01-18 05:47:16

|

1088人浏览过

|

来源于php中文网

原创

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.xmllog4j.properties,前者生效,后者被忽略

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

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

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j: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"/>
<appender-ref ref="console"/>
</root></p><p></log4j:configuration>

注意点:

Short AI
Short AI

AI短视频生成器,轻松创作爆款短视频!

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

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

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

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

1942

2024.04.01

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

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

2117

2024.08.01

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

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

1156

2024.11.28

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

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

1942

2024.04.01

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

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

2117

2024.08.01

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

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

1156

2024.11.28

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

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

788

2024.01.03

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

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

25

2025.12.06

Rust内存安全机制与所有权模型深度实践
Rust内存安全机制与所有权模型深度实践

本专题围绕 Rust 语言核心特性展开,深入讲解所有权机制、借用规则、生命周期管理以及智能指针等关键概念。通过系统级开发案例,分析内存安全保障原理与零成本抽象优势,并结合并发场景讲解 Send 与 Sync 特性实现机制。帮助开发者真正理解 Rust 的设计哲学,掌握在高性能与安全性并重场景中的工程实践能力。

4

2026.03.05

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL 教程
PostgreSQL 教程

共48课时 | 10.2万人学习

Git 教程
Git 教程

共21课时 | 4万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号