Java.time.Instant测试纳秒差异：远程构建失败咨询

报错信息 #

org.opentest4j.AssertionFailedError: expected: <2023-07-14T23:54:08.606213692Z> but was: <2023-07-14T23:54:08.606214Z>

当前使用的对比代码：

org.junit.jupiter.api.Assertions.assertEquals(expected.instant, actual.createdAt)

纳秒差异的原因 #

• 环境时钟精度差异：本地JVM可能支持高精度纳级时钟，而远程构建环境（如CI/CD服务器、容器）的系统时钟精度有限，导致Instant的纳秒部分被自动截断或四舍五入。
• 数据处理链路差异：如果Instant从数据库、缓存等存储介质读取，不同环境的存储组件对时间精度的处理规则可能不同（比如部分数据库默认只保留到微秒级别），导致远程环境获取的时间纳秒部分被调整。

忽略纳秒差异的测试方案 #

方案1：截断到指定时间单位对比 #

将两个Instant截断到相同的时间单位（如微秒）后再对比，规避纳秒级细微差异：

Assertions.assertEquals(
    expected.instant.truncatedTo(ChronoUnit.MICROS),
    actual.createdAt.truncatedTo(ChronoUnit.MICROS)
);

业务允许的话，也可以截断到毫秒（ChronoUnit.MILLIS）。

方案2：设置允许误差范围的断言 #

JUnit自定义误差判断

Duration timeDiff = Duration.between(expected.instant, actual.createdAt);
// 允许最多1微秒（1000纳秒）的差异
Assertions.assertTrue(timeDiff.abs().toNanos() <= 1000);

AssertJ简洁断言（需引入AssertJ依赖）

import org.assertj.core.api.Assertions;

Assertions.assertThat(actual.createdAt)
    .isCloseTo(expected.instant, Assertions.within(1, ChronoUnit.MICROS));

方案3：自定义相等比较器 #

为assertEquals指定自定义比较器，忽略纳秒级差异：

Assertions.assertEquals(
    expected.instant,
    actual.createdAt,
    (o1, o2) -> {
        if (o1.truncatedTo(ChronoUnit.MICROS).equals(o2.truncatedTo(ChronoUnit.MICROS))) {
            return null;
        }
        return String.format("时间差异超过微秒级：预期%s，实际%s", o1, o2);
    }
);

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