Java 日志框架清单-开发者社区

这份清单涵盖了Java生态中从核心门面（API）到具体实现（Impl），再到高性能异步方案的全景图。

为了方便快速决策，先按使用场景给出选型，下面是完整的分类清单。

你的场景	推荐组合	理由
新项目（Spring Boot 3.x）	Logback+SLF4J（默认）	原生支持，零配置即可用，性能均衡。
新项目（云原生/微服务）	Log4j2+SLF4J（异步模式）	性能最强（低延迟），支持Lambda延迟计算。
老旧系统整合	SLF4J+ 适配器桥接	统一打印格式，避免类路径中多套日志打架。
追求极致性能（高并发）	Log4j2（全异步）或Logback+Disruptor	Log4j2基于LMAX Disruptor，无锁化设计。
JSON日志（ELK/Kafka）	Logstash Logback Encoder或Log4j2 JSON Layout	直接输出结构化日志，无需解析正则。

核心价值：让代码与具体日志实现解耦，切换实现时无需修改代码。

框架名称	当前状态	关键说明
SLF4J（Simple Logging Facade for Java）	事实标准（必用）	目前最主流的门面，支持占位符`{}`，性能优于字符串拼接。
Apache Commons Logging（JCL）	逐渐淘汰	Spring 早期使用，存在类加载器问题，现已被SLF4J取代。
java.util.logging（JUL）	JDK 内置	功能简陋，无占位符，通常仅作为备用方案。

核心价值：负责格式化、过滤、输出到文件/控制台/数据库等。

框架名称	当前状态	性能特点	关键特性
Logback	主流默认	优秀（同步）	Spring Boot默认，原生实现SLF4J，支持自动重载配置。
Log4j2	性能王者	极强（异步）	支持Disruptor无锁异步，支持Lambda，需注意异步日志的上下文传递。
Log4j（1.x）	已废弃	差（有锁）	2022年停止维护，有严重漏洞，禁止在新项目使用。
java.util.logging（JUL）	JDK内置	一般	通常只用作为兜底实现。

核心价值：当项目中引入的第三方库使用了不同日志实现时，将这些日志重定向到你统一的门面上来。

桥接器 JAR	作用（将谁的日志劫持）	使用场景
jcl-over-slf4j	将JCL（commons-logging）的日志路由到 SLF4J	当引入Spring、Shiro等依赖时，防止JCL乱打印。
log4j-over-slf4j	将Log4j1.x的日志路由到 SLF4J	当引入老组件使用Log4j1时，将其日志纳入SLF4J管理。
jul-to-slf4j	将JUL（java.util.logging）的日志路由到 SLF4J	当引入使用JUL的组件（如Tomcat）时。

⚠️反模式警告：绝对不要同时引入log4j-over-slf4j和slf4j-log4j12，否则会造成无限循环死锁（StackOverflowError）。

组件名称	用途	一句话推荐
Logstash Logback Encoder	将Logback日志输出为JSON格式	对接ELK（Elasticsearch）的首选，直接输出结构化字段。
log4j2-jsonevent-layout	Log4j2的JSON格式化	Log4j2原生方案，性能优于Logback的Encoder。
Graylog / OpenSearch	日志收集服务端	配合上述JSON组件，实现集中式日志管理。
MDC（Mapped Diagnostic Context）	线程上下文传递（如TraceId）	SLF4J提供，用于在日志中打印请求链路ID，排错神器。
Disruptor	高性能无锁队列	Log4j2异步模式下依赖此库，实现微秒级日志写入。

框架名称	适用场景
tinylog	小型工具、Android、单元测试，只有一个JAR，无依赖。
slf4j-simple	JDK自带的简单实现，常用于本地调试，输出到`System.err`。

排除默认实现：在pom.xml中，一定要对传递性依赖的log4j、commons-logging执行<exclusions>。
禁止重复绑定：类路径（Classpath）中只能有一个日志实现绑定器（如logback-classic或log4j-slf4j-impl）。
异步日志注意事项：使用Log4j2异步时，需要配置AsyncLogger，并注意Disruptor的版本兼容性（Java 9+需用3.4.4+）。
敏感信息脱敏：切勿在日志中直接打印完整的身份证、密码等，建议使用PatternLayout配合替换规则，或在打印前手动脱敏。