在 java 日志记录中，使用桥接器 jcl-over-slf4j 的核心做法是将 apache commons logging (jcl) 的依赖替换为指向 slf4j 的桥接实现。具体操作是在项目中引入 jcl-over-slf4j 依赖并排除原有的 commons-logging 包，这样所有调用 jcl api 的代码都会自动转发到 slf4j，最终由你配置的底层日志框架（如 logback）处理。
如何配置 Maven 依赖以启用桥接
要启用桥接，需要在构建工具中正确声明依赖关系。对于 Maven 项目，你需要添加 jcl-over-slf4j 作为依赖，同时确保在传递性依赖中排除原始的 commons-logging。这能防止类路径冲突，确保 JCL 的接口被桥接器接管而非原始实现。
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>jcl-over-slf4j</artifactId>
<version>1.7.36</version>
</dependency>
<!-- 假设某个库依赖了 commons-logging，需要排除 -->
<dependency>
<groupId>some.library</groupId>
<artifactId>example-lib</artifactId>
<version>1.0</version>
<exclusions>
<exclusion>
<groupId>commons-logging</groupId>
<artifactId>commons-logging</artifactId>
</exclusion>
</exclusions>
</dependency>
上述配置确保了当代码调用 org.apache.commons.logging.LogFactory 时，实际加载的是桥接器类。运行此配置后，原本输出到控制台或文件的 JCL 日志将统一进入 SLF4J 的处理流程。预期结果是日志格式、级别控制完全由 SLF4J 的后端决定，且不再出现 "No appenders could be found" 等 JCL 警告。
立即学习“Java免费学习笔记（深入）”；
桥接器在运行时如何处理日志调用
桥接器在运行时通过静态初始化块注册自身为 JCL 的 LogFactory 实现。当应用程序首次请求日志实例时，桥接器会拦截该请求，并将其转换为 SLF4J 的调用。这意味着开发者无需修改业务代码中的日志调用语句，只需关注 SLF4J 的配置即可。
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
public class BridgeDemo {
private static final Log log = LogFactory.getLog(BridgeDemo.class);
public static void main(String[] args) {
log.info("This message is bridged to SLF4J");
}
}
在这个示例中，虽然使用了 LogFactory.getLog，但实际生成的日志对象是桥接器提供的代理。执行该程序时，如果 SLF4J 后端已配置（如 Logback），日志将正常输出。若未配置 SLF4J 后端，SLF4J 会使用 NOP 实现，导致日志静默丢弃，这是验证桥接是否生效的关键现象。
当 JCL 和 SLF4J 共存时会发生什么
如果项目中同时存在原始的 commons-logging 和桥接器，且未正确排除前者，会导致日志重复输出或行为不一致。JCL 会优先加载其原始实现，绕过桥接器，而直接调用 SLF4J 的代码则走 SLF4J 流程。这种混合状态会使日志管理变得混乱，难以追踪来源。
解决此问题的关键是确保类路径中只有一个 JCL 相关的有效入口。通过 Maven 的 dependency:tree 命令可以检查是否存在多个版本的 JCL 或桥接器。确认只有 jcl-over-slf4j 存在后，所有 JCL 调用都将统一路由。若发现日志丢失，检查是否意外排除了桥接器本身，或者 SLF4J 后端是否正确绑定。
