jcl-over-slf4j是将jcl日志调用无缝重定向至slf4j的桥接包，需排除commons-logging依赖并确保版本匹配，而slf4j-jcl方向相反、极少使用。
Java 项目中常遇到老旧框架（如 Spring 3.x、Apache HttpClient、Commons Logging 等）默认使用 JCL（Jakarta Commons Logging） 输出日志，而现代项目已统一采用 SLF4J + Logback/Log4j2。要让这些 JCL 日志也进入 SLF4J 通道，关键不是重写代码，而是通过 日志桥接（JCL-over-SLF4J） 替换 JCL 的实现。
为什么用 jcl-over-slf4j 而不是 slf4j-jcl
注意区分方向：slf4j-jcl 是把 SLF4J 日志转发给 JCL（反向桥接，极少用）；而 jcl-over-slf4j 才是将原本调用 JCL 的代码，无缝重定向到 SLF4J——这才是统一日志输出的核心桥接包。
- 它提供了一个与 JCL API 完全兼容的
org.apache.commons.logging.Log实现 - 所有
LogFactory.getLog(...)调用，底层实际创建的是 SLF4J 的Logger - 无需修改任何一行业务或框架源码
正确引入和排除依赖
只加 jcl-over-slf4j 不够，必须确保原始 JCL 的 commons-logging.jar 被彻底排除，否则类加载器可能优先加载原生 JCL，桥接失效。
- Maven 中显式添加桥接包，并 排除传递依赖里的 commons-logging
- 如果项目里已有
spring-core（它依赖 commons-logging），需在 dependency 中声明<exclusions></exclusions> - 检查最终 classpath：运行时不应存在
org.apache.commons.logging.*的原始实现类（可用mvn dependency:tree -Dverbose确认）
避免桥接冲突的典型场景
混合使用多种日志桥接包（如同时引入 log4j-over-slf4j 和 jul-to-slf4j）时，要注意顺序和覆盖范围：
- JCL 桥接仅接管
org.apache.commons.logging的调用，不影响 java.util.logging（JUL）或 Log4j 1.x 原生输出 - 若项目还用了 JUL（如某些容器或老 SDK），需额外启用
jul-to-slf4j并调用SLF4JBridgeHandler.install() - 确保桥接包版本与 SLF4J 主版本一致（例如 SLF4J 2.x 需用
jcl-over-slf4j-2.0.13.jar，不兼容 1.x 版本）
验证桥接是否生效
最直接的方式：在启动日志中搜索关键词，或主动触发一段 JCL 日志输出。
- 启动应用后，查看控制台或日志文件，确认原本由 Spring 或 HttpClient 输出的日志，格式、前缀、级别与你配置的 SLF4J 后端（如 Logback）完全一致
- Log log = LogFactory.getLog("test"); log.info("JCL test message");，观察该日志是否出现在 SLF4J 绑定的日志文件中
- 如果仍看到
[commons-logging]风格日志（如无时间戳、无线程名），说明桥接未生效，大概率是commons-logging.jar未被排除干净
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
