日志记录时的方法解析：为何() -> String.format(...)不被识别为Supplier<String>？

问题重现 #

代码示例：

Logger logger = LogManager.getLogger("MyLogger");

/**
 * 作为外观模式的语法糖
 */
private void logAtLevel(String level, Supplier<String> messageSupplier, Throwable thrown){
      Level priority = Level.toLevel(level, Level.ALL);
      if (null == thrown) {
         logger.log(priority, messageSupplier);
      } else {
         logger.log(priority, messageSupplier, thrown);
      }

}

/**
 * 调用日志记录的方法
 */
private void callLogging(Object value){
   logAtLevel("Debug", ()->String.format("something or other: %s", value), null);

}

期望输出日志条目：something or other: <object.toString()>，实际输出：lambda@1223454，说明调用了log(Level, Object)方法而非预期的log(Level, Supplier<?>)方法。

原因分析 #

1. 版本兼容性问题：如果使用的Log4j2版本低于2.4，Logger接口尚未提供接收Supplier参数的log(Level level, Supplier<?> msgSupplier)重载方法，此时编译器只能匹配到log(Level level, Object msg)方法，将Supplier实例当作普通Object处理，输出其默认toString()结果（即lambda的标识字符串）。
2. 重载匹配歧义：即使版本符合要求，Java编译器在解析重载方法时，若存在log(Level, Object)（具体实现方法）和log(Level, Supplier<?>)（接口默认方法），部分场景下编译器会优先选择具体实现方法，导致Supplier未被正确解析为延迟加载的消息提供者。

解决方法 #

方法1：升级Log4j2到2.4及以上版本 #

这是最根本的解决方式，新版本的Log4j2原生支持Supplier类型的日志参数，编译器会正确匹配到对应的重载方法，自动触发延迟加载逻辑，输出预期的日志内容。

方法2：显式引导编译器匹配Supplier重载（无需强制转换） #

通过先判断日志级别是否启用，引导编译器明确匹配Supplier参数的重载方法：

private void logAtLevel(String level, Supplier<String> messageSupplier, Throwable thrown){
    Level priority = Level.toLevel(level, Level.ALL);
    if (null == thrown) {
        if (logger.isEnabled(priority)) {
            logger.log(priority, messageSupplier);
        }
    } else {
        // Log4j2无直接接收Supplier+Throwable的重载，需先获取消息内容
        if (logger.isEnabled(priority)) {
            logger.log(priority, messageSupplier.get(), thrown);
        }
    }
}

方法3：使用ExtendedLogger消除匹配歧义 #

由于Logger继承自ExtendedLogger，可以调用其更明确的重载方法，避免匹配歧义（仅需一次接口转换，风险极低）：

private void logAtLevel(String level, Supplier<String> messageSupplier, Throwable thrown){
    Level priority = Level.toLevel(level, Level.ALL);
    ExtendedLogger extendedLogger = (ExtendedLogger) logger;
    if (null == thrown) {
        extendedLogger.log(null, LogManager.ROOT_LOGGER_NAME, priority, null, messageSupplier, null);
    } else {
        extendedLogger.log(null, LogManager.ROOT_LOGGER_NAME, priority, null, messageSupplier.get(), thrown);
    }
}

内容的提问来源于stack exchange，提问作者leuchtstoffratte