Log4j指定包日志输出到独立文件仅创建不写入内容问题求助

问题根因排查 #

你遇到的报错核心指向两个问题：文件句柄被提前关闭、appender未正确绑定输出流，常见原因如下：

1. 自定义com.util.PrettyHTMLLayout实现异常，导致appender初始化时输出流绑定中断，仅完成文件创建，后续写入逻辑失效
2. 同一个file.appender同时被自定义logger和root logger持有，多实例操作导致文件句柄被重复关闭，出现Bad file descriptor错误
3. JBoss容器自带的log4j组件与项目内的log4j配置冲突，appender被容器日志进程重复初始化/销毁
4. jboss.server.home.dir变量解析异常，或是日志目录权限不足、文件被其他进程锁定

解决方案 #

1. 排除自定义Layout问题 #

先将文件appender的布局替换为log4j标准实现，验证是否是自定义类的问题：

<appender name="file.appender" class="org.apache.log4j.RollingFileAppender">
    <param name="file" value="${jboss.server.home.dir}/log/mainLog.log"/>
    <param name="Append" value="true"/>
    <param name="MaxFileSize" value="5MB"/>
    <param name="MaxBackupIndex" value="20"/>
    <!-- 替换为标准PatternLayout -->
    <layout class="org.apache.log4j.PatternLayout">
        <param name="ConversionPattern" value="%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n"/>
    </layout>
</appender>

如果替换后可以正常写入日志，说明PrettyHTMLLayout存在逻辑问题，需要检查该类的format、getHeader、getFooter等方法是否抛出未捕获的异常。

2. 拆分独立日志的appender #

指定包的独立日志不要和root logger共用同一个文件appender，单独配置专属appender避免冲突：

<!-- 新增独立appender -->
<appender name="pbuild.appender" class="org.apache.log4j.RollingFileAppender">
    <param name="file" value="${jboss.server.home.dir}/log/pbuild.log"/>
    <param name="Append" value="true"/>
    <param name="MaxFileSize" value="5MB"/>
    <param name="MaxBackupIndex" value="20"/>
    <layout class="org.apache.log4j.PatternLayout">
        <param name="ConversionPattern" value="%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n"/>
    </layout>
</appender>

<!-- 自定义logger仅引用专属appender -->
<logger name="com.tson.dev.pbuild" additivity="false">
    <level value="INFO"/>
    <appender-ref ref="console.appender"/>
    <appender-ref ref="pbuild.appender"/>
</logger>

<!-- root logger不引用独立日志的appender -->
<root>
    <priority value="INFO"/>
    <appender-ref ref="console.appender"/>
    <appender-ref ref="file.appender"/>
</root>

3. 解决JBoss日志类加载冲突 #

在项目的WEB-INF/jboss-web.xml中添加类加载配置，优先加载项目内的log4j配置，避免容器自带日志组件干扰：

<jboss-web>
    <class-loading java2ClassLoadingCompliance="false">
        <loader-repository>
            <!-- 替换为你自己的项目标识 -->
            com.yourcompany:archive=your_project_name.war
            <loader-repository-config>java2ParentDelegation=false</loader-repository-config>
        </loader-repository>
    </class-loading>
</jboss-web>

4. 验证路径与权限 #

• 先将日志路径替换为绝对路径测试，排除jboss.server.home.dir变量解析错误的问题
• 确认JBoss运行用户对日志目录有读写权限，且没有日志采集、杀毒等进程锁定日志文件
• 可将log4j配置的debug="false"改为debug="true"，启动时查看log4j初始化的详细日志，定位appender初始化阶段的异常

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