system.logger 是 jdk 9+ 的轻量级日志接口而非实现，需依赖 jdk-logging-bridge 桥接到 slf4j 才能复用 logback/log4j2；必须显式初始化、避免混用 api、注意名称传递与 mdc 手动透传。
System.Logger 是 JDK 9+ 的轻量级日志接口，不是实现
很多人一看到 System.getLogger 就以为它能直接替代 slf4j 或 log4j2，其实不然。System.Logger 只是一组接口（System.Logger、System.LoggerFinder），JDK 自身不提供日志后端实现，运行时会委托给当前 classpath 中第一个可用的 LoggerFinder 实现。这意味着：如果你没引入任何桥接器（如 jdk-logging-bridge），调用 System.getLogger("x") 会抛出 NoClassDefFoundError 或静默回退到空实现（取决于 JDK 版本）。
所以跨库统一抽象的前提不是“用 System.Logger 写日志”，而是“确保所有模块都通过同一套 LoggerFinder 绑定到同一个底层日志系统”。
必须显式引入并配置 jdk-logging-bridge
Oracle 提供了官方桥接器 jdk-logging-bridge（Maven 坐标：org.slf4j:jdk-logging-bridge），它让 System.Logger 调用自动转给 SLF4J，从而复用你已有的 logback-classic 或 log4j-slf4j2-impl。
关键点：
- 该桥接器必须出现在 classpath 顶层（不能被其他 logger binding 覆盖），且需在应用启动早期触发加载（例如在
main方法第一行调用SLF4JBridgeHandler.install()） - 不依赖
ServiceLoader自动发现——它靠静态代码块注册java.util.logging.LogManager的 handler，再由System.LoggerFinder拦截请求 - 如果你用的是 JDK 17+，注意
jdk-logging-bridge2.0.0+ 才完全支持System.LoggerAPI；旧版只桥接java.util.logging
示例初始化：
public class Bootstrap {
static {
SLF4JBridgeHandler.removeHandlersForRootLogger();
SLF4JBridgeHandler.install();
}
}
避免混用 System.Logger 和 SLF4J 原生 API
一旦启用桥接，所有 System.getLogger("x") 都走 SLF4J，但如果你在同一个项目里同时写 LoggerFactory.getLogger("x") 和 System.getLogger("x")，会出现两个独立的 logger 实例，导致 MDC 不同步、级别不一致、甚至日志重复。
正确做法是：在模块边界做隔离，比如：
- 公共基础库（如 utils、client sdk）只依赖
System.Logger，不引入 slf4j-api - 业务应用层统一引入
jdk-logging-bridge+ 具体实现（如logback-classic），并禁止直接使用LoggerFactory - 第三方库若自带 SLF4J 日志，可通过
logback.xml的<logger name="xxx" level="off"></logger>控制，而非指望System.Logger覆盖它
Logger 名称传递与上下文丢失是高频陷阱
System.Logger 的 log(Level, String) 不接受 Supplier<string></string>，也不原生支持结构化参数（如 {}, {} 占位符）。虽然桥接器会尝试解析，但遇到异常堆栈或 lambda 表达式时容易出错。
更隐蔽的问题是：某些框架（如 Spring Boot 3.2+ 的 AOT 处理、GraalVM native image）会剥离 System.Logger 的调用栈推导逻辑，导致 getLogger("x") 返回的 logger 名称变成 "" 或 "unknown"，最终所有日志挤在 root logger 下。
应对方式：
- 始终显式传入名称：
System.getLogger(MyClass.class.getName())，别依赖getClass().getName()在 lambda 里动态获取 - 避免在
static final字段中缓存System.Logger实例（部分LoggerFinder实现不保证线程安全初始化） - 若需 MDC，必须手动透传：
org.slf4j.MDC.put("traceId", id)——System.Logger本身无 MDC 概念
跨库抽象真正难的从来不是接口替换，而是让不同构建阶段、不同类加载器、不同日志生命周期下的 logger 名称和上下文行为保持一致。这点上，System.Logger 提供的是契约，不是保障。
