Log4j2在JBoss 7.4的JAX-RS Servlet项目中无法输出日志

以下是针对问题的逐一排查和解决步骤：

1. 确认log4j2.xml配置文件的有效性 #

• 检查文件位置：打包后的WAR文件中，log4j2.xml必须位于WEB-INF/classes目录下。解压WAR包验证这一点，如果缺失，检查项目构建配置（比如Maven的resources插件是否正确包含该文件）。
• 验证配置格式：确保配置文件中定义了至少一个有效的Appender，并且根日志级别设置为INFO或更低。示例配置如下：

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="INFO">
    <Appenders>
        <Console name="Console" target="SYSTEM_OUT">
            <PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
        </Console>
        <File name="ServerLog" fileName="${sys:jboss.server.log.dir}/server.log">
            <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
        </File>
    </Appenders>
    <Loggers>
        <Root level="info">
            <AppenderRef ref="Console"/>
            <AppenderRef ref="ServerLog"/>
        </Root>
    </Loggers>
</Configuration>

• 注意：status="INFO"会输出Log4j2自身的初始化日志，启动时可以观察控制台是否有Log4j2的加载信息，以此判断配置文件是否被识别。

2. 完善jboss-deployment-structure.xml的排除规则 #

JBoss 7.4的日志子系统涉及多个模块，仅排除基础模块可能不够。确保你的配置排除所有可能冲突的日志相关模块：

<jboss-deployment-structure>
    <deployment>
        <exclusions>
            <module name="org.jboss.logging"/>
            <module name="org.apache.log4j"/>
            <module name="org.slf4j"/>
            <module name="org.slf4j.impl"/>
        </exclusions>
    </deployment>
</jboss-deployment-structure>

这个配置会强制JBoss使用你打包的Log4j2依赖，而不是服务器自带的日志实现。

3. 检查依赖完整性与冲突 #

• 添加SLF4J桥接依赖：如果你的项目中使用了SLF4J API（比如代码中用org.slf4j.Logger），必须添加log4j-slf4j-impl-2.20.0.jar到lib目录，否则SLF4J无法绑定到Log4j2，导致日志无输出。
• 排查依赖冲突：使用mvn dependency:tree（Maven项目）或直接检查lib目录，确保没有同时存在其他日志框架的实现Jar包（比如slf4j-jdk14.jar、logback-classic.jar等），这些会与Log4j2产生冲突。

4. 确认日志实例的获取方式 #

确保你在ExampleServiceImpl中使用Log4j2的原生API获取Logger：

import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;

public class ExampleServiceImpl {
    private static final Logger logger = LogManager.getLogger(ExampleServiceImpl.class);

    public void someMethod() {
        // 可以先打印System.out确认方法被调用
        System.out.println("Method called, attempting to log...");
        logger.info("This is a test info log");
    }
}

如果错误使用了JBoss的org.jboss.logging.Logger，即使排除了子系统，也会导致日志无法通过Log4j2输出。

5. 检查JBoss服务器的日志级别限制 #

JBoss的日志子系统可能会限制全局输出级别。打开standalone/configuration/standalone.xml，找到日志子系统配置，确保相关Handler的级别设置为INFO或更低：

<subsystem xmlns="urn:jboss:domain:logging:8.0">
    <console-handler name="CONSOLE">
        <level name="INFO"/> <!-- 确保这里不是WARN或ERROR -->
        <formatter>
            <named-formatter name="COLOR-PATTERN"/>
        </formatter>
    </console-handler>
    <periodic-rotating-file-handler name="FILE" autoflush="true">
        <level name="INFO"/> <!-- 同样检查这个级别 -->
        <formatter>
            <named-formatter name="PATTERN"/>
        </formatter>
        <file relative-to="jboss.server.log.dir" path="server.log"/>
        <suffix value=".yyyy-MM-dd"/>
        <append value="true"/>
    </periodic-rotating-file-handler>
</subsystem>

6. 验证类加载来源 #

如果以上步骤都无效，检查Log4j2的类是否从你的项目Jar包加载。在JBoss启动参数中添加-verbose:class，启动后搜索org.apache.logging.log4j.LogManager，查看加载路径是否指向你的WAR包中的log4j-api-2.20.0.jar，而不是JBoss服务器自带的Jar包。

内容的提问来源于stack exchange，提问作者TimeToCode