Kotlin-logging项目中的日志类名打印问题解析

在Kotlin-logging项目使用过程中，开发者发现了一个关于日志类名打印不准确的问题。本文将深入分析该问题的原因、影响范围以及解决方案。

问题现象

当开发者使用LoggingEventBuilder并添加payload时，输出的日志中显示的类名不正确。具体表现为：

logger.atInfo {
    message = "hi"
    payload = mapOf("k" to "v")
}

这种情况下，日志输出的类名会显示为io.github.oshai.kotlinlogging.slf4j.internal.LocationAwareKLogger，而不是预期的实际调用类名my.pkg.MyClassKt。

问题根源

经过分析，这个问题源于SLF4J实现中的差异：

1. 无payload的日志调用：使用LocationAwareLogger.log()方法，该方法能正确识别调用者的类名
2. 有payload的日志调用：使用LoggingEventBuilder.log()方法，该方法在实现中会覆盖callerBoundary信息

问题的本质在于SLF4J的DefaultLoggingEventBuilder实现中，在调用log(String message)方法时，会使用自身的类名覆盖掉正确的调用者类名信息。

影响范围

该问题主要影响以下场景：

• 使用Kotlin-logging库的项目
• 通过LoggingEventBuilder添加payload的日志记录
• 使用SLF4J 2.0.13以下版本的后端实现

解决方案

该问题已在SLF4J 2.0.13版本中得到修复。升级到该版本后，日志输出的类名将正确显示实际调用者的类名。

对于开发者来说，解决方案很简单：

1. 确保项目使用的SLF4J版本升级到2.0.13或更高
2. 更新Kotlin-logging库到最新版本

技术启示

这个问题给我们带来了一些技术思考：

1. 日志框架的调用链追踪：现代日志框架需要准确追踪调用链信息，这对调试和问题定位至关重要
2. API设计的一致性：同一个日志框架的不同API路径应该保持一致的实现逻辑
3. 依赖管理的重要性：及时更新依赖库可以避免已知问题的困扰

通过这个案例，我们也可以看到开源社区如何协作解决问题，从问题报告到最终修复的完整过程。