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>

注意点:

天工大模型
天工大模型

中国首个对标ChatGPT的双千亿级大语言模型

下载
  • 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

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

豆包大模型
豆包大模型

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

WorkBuddy
WorkBuddy

腾讯云推出的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)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1948

2024.04.01

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

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

2119

2024.08.01

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

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

1168

2024.11.28

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

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

1948

2024.04.01

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

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

2119

2024.08.01

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

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

1168

2024.11.28

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

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

871

2024.01.03

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

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

30

2025.12.06

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

76

2026.03.11

热门下载

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

精品课程

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

共48课时 | 10.6万人学习

Git 教程
Git 教程

共21课时 | 4.2万人学习

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

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