Spring Boot3.3+Java17下Logback日志纳秒时间戳不生效问题

问题根源 #

你碰到的情况本质是：Logback的ch.qos.logback.classic.spi.LoggingEvent类默认只记录毫秒级时间戳（timeStamp属性）。哪怕你在配置里写了%d{HH:mm:ss.SSSSSSSSS}或%date{HH:mm:ss.SSSSSSSSS}，Logback也只是把毫秒值补零填充到纳秒位，不会真正获取并使用纳秒精度的时间数据——比如你看到的12:30:17:815000000，其实就是815毫秒扩展成的纳秒格式，没有实际的纳秒级精度。

虽然Java 9+原生支持纳秒精度，Log4j也适配了纳秒格式的日期解析，但Logback的默认事件模型没跟进：它的LoggingEvent在构造时只调用了System.currentTimeMillis()，没有捕获纳秒级的时间信息（比如System.nanoTime()或Instant.now()的纳秒部分）。

实用解决方案 #

1. 自定义Logback转换器（推荐，低侵入） #

写一个自定义转换器来获取纳秒级时间，替换默认的日期格式符：

• 创建转换器类：

import ch.qos.logback.classic.pattern.ClassicConverter;
import ch.qos.logback.classic.spi.ILoggingEvent;
import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;

public class NanoTimestampConverter extends ClassicConverter {
    private static final DateTimeFormatter NANO_FORMAT = DateTimeFormatter.ofPattern("HH:mm:ss.SSSSSSSSS");

    @Override
    public String convert(ILoggingEvent event) {
        // 这里用日志输出时的纳秒时间，若需要事件产生时的精确时间，可参考下方扩展方案
        return LocalDateTime.now().format(NANO_FORMAT);
    }
}

• 在logback-spring.xml中注册并使用：

<configuration>
    <!-- 注册自定义转换器，指定conversionWord为nanoDate -->
    <conversionRule conversionWord="nanoDate" converterClass="com.your.package.NanoTimestampConverter"/>
    
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <!-- 用%nanoDate替代原来的%d -->
            <pattern>%nanoDate [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>
    
    <root level="info">
        <appender-ref ref="CONSOLE"/>
    </root>
</configuration>

2. 扩展LoggingEvent（高精准，稍侵入） #

如果需要严格记录日志事件产生瞬间的纳秒时间（而非输出时的时间），可以扩展LoggingEvent：

• 自定义事件类：

import ch.qos.logback.classic.spi.LoggingEvent;
import java.time.Instant;

public class NanoLoggingEvent extends LoggingEvent {
    private final int nanoOfSecond;

    public NanoLoggingEvent(String fqnOfLoggerClass, ch.qos.logback.classic.Logger logger, 
                           ch.qos.logback.classic.Level level, String message, Throwable throwable, Object[] argArray) {
        super(fqnOfLoggerClass, logger, level, message, throwable, argArray);
        this.nanoOfSecond = Instant.now().getNano();
    }

    public int getNanoOfSecond() {
        return nanoOfSecond;
    }
}

• 再自定义Logger子类来生成这个事件，并配置Logback使用自定义Logger工厂。这种方式精准度最高，但需要修改Logback的默认事件生成逻辑，侵入性较强，适合对时间精度有极致要求的场景。

为什么默认配置不生效？ #

Logback的设计逻辑里，LoggingEvent的timeStamp字段一直是毫秒级的。虽然1.5.x版本支持解析纳秒格式的字符串，但底层没有对应的纳秒时间数据源——它只是把毫秒值乘以1000000后补零填充，所以你看到的纳秒位全是零，没有实际的精度提升。

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