Log4j 1.x 迁移至 Log4j 2.x：解决XML配置命名空间绑定问题-java教程-PHP中文网

Log4j 1.x 迁移至 Log4j 2.x：解决XML配置命名空间绑定问题

聖光之護

发布： 2025-08-20 16:46:24

原创

882人浏览过

log4j 1.x 迁移至 log4j 2.x：解决xml配置命名空间绑定问题

在将Log4j 1.x项目迁移至Log4j 2.x时，一个常见的问题是XML配置文件中的命名空间绑定错误，例如 "The prefix "log4j" for element "log4j:configuration" is not bound."。这个问题通常是由于Log4j 2.x不再使用Log4j 1.x的XML配置格式导致的。本文将详细介绍如何解决这个问题，并提供一个完整的迁移指南。

1. 更新依赖

首先，需要确保项目中使用的Log4j 2.x的依赖是正确的。在Maven项目中，可以这样更新pom.xml文件：

<dependency>
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-api</artifactId>
    <version>2.17.1</version>
</dependency>
<dependency>
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-core</artifactId>
    <version>2.17.1</version>
</dependency>

登录后复制

请根据实际情况选择合适的Log4j 2.x版本。

2. 修改代码

接下来，需要修改代码中引用Log4j的方式。 Log4j 2.x使用不同的类和方法。

导入包的修改：

将Log4j 1.x的导入：

import org.apache.log4j.Logger;
import org.apache.log4j.xml.DOMConfigurator;

登录后复制

替换为Log4j 2.x的导入：

import org.apache.logging.log4j.Logger;
import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.core.config.Configurator;

登录后复制

获取Logger实例的修改：

将Log4j 1.x的获取Logger实例的方式：

private static Logger myLogger = Logger.getLogger(MyCustomClass.class);

登录后复制

替换为Log4j 2.x的方式：

private static Logger myLogger = LogManager.getLogger(MyCustomClass.class);

登录后复制

配置文件的加载方式的修改：

将Log4j 1.x的配置文件加载方式：
```
DOMConfigurator.configure("/home/user/TEST_log4j.xml");
```
登录后复制
替换为Log4j 2.x的方式：
```
Configurator.initialize(null, "/home/user/TEST_log4j.xml");
```
登录后复制

3. 修改XML配置文件

Log4j 2.x使用不同的XML配置格式。需要将Log4j 1.x的配置文件转换为Log4j 2.x的格式。

X Studio

网易云音乐·X Studio

查看详情

根节点修改：

将Log4j 1.x的根节点：
```
<log4j:configuration>
```
登录后复制
替换为Log4j 2.x的根节点：
```
<Configuration>
```
登录后复制

Appender的配置修改：

将Log4j 1.x的Appender配置：

<appender name="ConsoleAppender" class="org.apache.log4j.ConsoleAppender">
    <layout class="org.apache.log4j.PatternLayout">
      <param name="ConversionPattern" value="%d{MM/dd HH:mm:ss} %-5p %30.30c %x - %m\n"/>
    </layout>
</appender>
<appender name="Fileappender" class="org.apache.log4j.RollingFileAppender">
    <param name="file" value="/opt/tomcat/logs/MyCustomClassLogs.log"/>
    <param name="MaxFileSize" value="5MB"/>
    <param name="MaxBackupIndex" value="5"/>
    <layout class="org.apache.log4j.PatternLayout">
        <param name="ConversionPattern" value="%d{MM/dd HH:mm:ss} %-5p %30.30c %x - %m\n"/>
    </layout>
</appender>

登录后复制

替换为Log4j 2.x的Appender配置：

<Appenders>
    <Console name="STDOUT" target="SYSTEM_OUT">
        <PatternLayout pattern="%d{MM/dd HH:mm:ss} %-5p %30.30c %x - %m\n"/>
    </Console>
    <RollingFile name="RollingFile" fileName="/opt/tomcat/logs/MyCustomClassLogs.log" filePattern="/opt/tomcat/logs/MyCustomClassLogs.log-%i">
        <PatternLayout>
            <pattern>%d{MM/dd HH:mm:ss} %-5p %30.30c %x - %m\n</pattern>
        </PatternLayout>
        <Policies>
            <SizeBasedTriggeringPolicy size="5 MB" />
        </Policies>
        <DefaultRolloverStrategy max="5"/>
    </RollingFile>
</Appenders>

登录后复制

注意：org.apache.log4j.RollingFileAppender 对应于 Log4j 2.x 中的 RollingFile，且配置方式有所不同。 param 标签被移除，相应的属性直接在标签上设置。

Logger的配置修改：

将Log4j 1.x的Logger配置：

<category name="com.demo.custom.filter.ResetClass" additivity="false">
    <priority value="TRACE"/>
    <appender-ref ref="ResetClass"/>
</category>
<root>
    <level value="error" />
    <appender-ref ref="ConsoleAppender"/>
</root>

登录后复制

替换为Log4j 2.x的Logger配置：

<Loggers>
    <Logger name="com.demo.custom.filter.ResetClass" level="TRACE">
        <AppenderRef ref="ResetClass"/>
    </Logger>
    <Root level="error">
        <AppenderRef ref="STDOUT"/>
    </Root>
</Loggers>

登录后复制

注意：Log4j 2.x 使用 <Loggers> 标签包含所有的 <Logger> 和 <Root>。 priority 属性被 level 属性替代。

4. 完整的Log4j 2.x XML配置示例

以下是一个完整的Log4j 2.x XML配置示例：

<Configuration>
    <Appenders>
        <Console name="STDOUT" target="SYSTEM_OUT">
            <PatternLayout pattern="%d{MM/dd HH:mm:ss} %-5p %30.30c %x - %m\n"/>
        </Console>
        <RollingFile name="RollingFile" fileName="/opt/tomcat/logs/MyCustomClassLogs.log" filePattern="/opt/tomcat/logs/MyCustomClassLogs.log-%i">
            <PatternLayout>
                <pattern>%d{MM/dd HH:mm:ss} %-5p %30.30c %x - %m\n</pattern>
            </PatternLayout>
            <Policies>
                <SizeBasedTriggeringPolicy size="5 MB" />
            </Policies>
            <DefaultRolloverStrategy max="5"/>
        </RollingFile>
        <RollingFile name="ResetClass" fileName="/opt/tomcat/logs/resetTrace.log" filePattern="/opt/tomcat/logs/resetTrace.log-%i">
            <PatternLayout>
                <pattern>%d{MM/dd HH:mm:ss} %-5p %30.30c %x - %m\n</pattern>
            </PatternLayout>
            <Policies>
                <SizeBasedTriggeringPolicy size="5 MB" />
            </Policies>
            <DefaultRolloverStrategy max="5"/>
        </RollingFile>
    </Appenders>
    <Loggers>
        <Logger name="com.demo.custom.filter.ResetClass" level="TRACE">
            <AppenderRef ref="ResetClass"/>
        </Logger>
        <Logger name="com.demo.custom.test.MyCustomClass" level="TRACE">
            <AppenderRef ref="RollingFile"/>
        </Logger>
        <Root level="error">
            <AppenderRef ref="STDOUT"/>
        </Root>
    </Loggers>
</Configuration>

登录后复制