JBoss/Log4j2环境下禁用DEBUG日志的实用指南
在JBoss应用服务器中部署使用了Log4j2作为日志框架的应用时，默认情况下可能会输出大量DEBUG级别的日志，这些日志不仅会增加磁盘I/O开销，还可能包含敏感信息，影响系统的运行效率和安全性。本文将详细介绍在JBoss/Log4j2环境下禁用DEBUG日志的几种常用方法，帮助开发者快速完成日志级别的调整。
方法一：修改应用自身的Log4j2配置文件
大多数基于Log4j2的应用都会自带log4j2.xml或log4j2.properties配置文件，这是最直接的控制日志级别的方式。我们可以在应用的配置文件中全局或针对特定包禁用DEBUG日志。
以下是log4j2.xml的示例配置，将根日志级别设置为INFO，同时针对特定业务包单独设置日志级别，避免不必要的DEBUG日志输出：
<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
<Appenders>
<Console name="Console" target="SYSTEM_OUT">
<PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
</Console>
</Appenders>
<Loggers>
<!-- 根日志级别设置为INFO，禁用所有DEBUG及以下级别的日志 -->
<Root level="info">
<AppenderRef ref="Console"/>
</Root>
<!-- 针对特定业务包设置日志级别，避免该包下的DEBUG日志输出 -->
<Logger name="com.example.business" level="info" additivity="false">
<AppenderRef ref="Console"/>
</Logger>
<!-- 可以针对第三方依赖包单独设置级别，比如禁用某个框架的DEBUG日志 -->
<Logger name="org.springframework" level="warn" additivity="false">
<AppenderRef ref="Console"/>
</Logger>
<Loggers>
</Configuration>修改完成后，将更新后的配置文件重新打包到应用的WEB-INF/classes目录下，或者放到JBoss的模块路径中供应用加载，重启应用即可生效。
方法二：通过JBoss启动参数调整日志级别
如果不想修改应用本身的配置文件，也可以通过JBoss的启动参数来覆盖Log4j2的日志级别配置，这种方式不需要重新打包应用，适合临时调整或者生产环境快速生效的场景。
以JBoss EAP 7.x为例，我们可以在启动脚本standalone.conf（Linux环境）或standalone.conf.bat（Windows环境）中添加如下JVM参数：
# Linux环境 standalone.conf 中添加 JAVA_OPTS="$JAVA_OPTS -Dlog4j2.rootLogger.level=info" # 如果需要针对特定包设置，可以添加多个参数 JAVA_OPTS="$JAVA_OPTS -Dlog4j2.logger.com.example.business.level=info"
:: Windows环境 standalone.conf.bat 中添加 set "JAVA_OPTS=%JAVA_OPTS% -Dlog4j2.rootLogger.level=info" set "JAVA_OPTS=%JAVA_OPTS% -Dlog4j2.logger.com.example.business.level=info"
添加完成后重启JBoss服务，这些参数会覆盖应用内部Log4j2配置中的根日志级别和指定包的日志级别，从而实现禁用DEBUG日志的目的。
方法三：修改JBoss容器级别的日志配置
如果需要在JBoss容器层面统一控制所有部署应用的Log4j2日志级别，可以修改JBoss的日志子系统配置。这种方式适合管理多个部署在JBoss上的应用，不需要逐个修改应用的配置。
我们可以通过JBoss的命令行管理工具jboss-cli.sh（Linux）或jboss-cli.bat（Windows）执行如下命令，调整容器级别的日志级别：
# 连接到JBoss管理端 ./jboss-cli.sh --connect # 设置根日志级别为INFO，禁用DEBUG日志 /subsystem=logging/root-logger=ROOT:write-attribute(name=level,value=INFO) # 添加针对特定包的日志级别配置，比如禁用com.example包的DEBUG日志 /subsystem=logging/logger=com.example:add(level=INFO) # 如果需要针对使用Log4j2的应用单独处理，可以添加自定义日志类别 /subsystem=logging/logger=org.apache.logging.log4j:add(level=INFO)
执行完命令后，配置会自动生效，不需要重启JBoss服务，所有部署在容器内的应用都会遵循容器级别的日志级别设置，DEBUG日志会被自动过滤。
验证配置是否生效
完成配置调整后，我们可以通过查看应用的运行日志来验证DEBUG日志是否已经被禁用。如果日志中不再出现DEBUG级别的日志输出，说明配置生效；如果仍然存在DEBUG日志，可以按照以下步骤排查：
- 检查配置文件中的日志级别是否正确设置为info或更高（warn、error）
- 确认配置文件是否被正确加载，查看应用启动日志中是否有Log4j2加载配置的相关信息
- 如果是通过启动参数配置，检查JVM参数是否被正确传递，可以通过
jps -v命令查看Java进程的启动参数 - 如果是容器级别配置，通过
/subsystem=logging:read-resource(recursive=true)命令查看当前日志子系统的配置是否正确
注意事项
在禁用DEBUG日志时需要注意，部分应用在DEBUG级别下会输出关键的调试信息，如果是排查问题阶段，建议暂时开启DEBUG日志，定位问题完成后再关闭。另外，如果应用使用了自定义的日志输出方式，可能需要额外调整对应的日志配置，确保所有的DEBUG日志都被正确过滤。