为JPA测试创建DateTimeProvider Bean以模拟固定时间

问题根源 #

你当前的代码存在三个核心冲突点，直接导致MockBean注入失效、空指针异常：

1. 同时导入了真实的TestDateTimeProvider Bean（名为testDateTimeProvider）和用@MockBean声明的Mock版DateTimeProvider Bean（默认名为dateTimeProvider），Spring容器内出现同类型不同名的Bean，注入逻辑混乱。
2. @EnableJpaAuditing(dateTimeProviderRef = "testDateTimeProvider")明确指定JPA审计使用名为testDateTimeProvider的Bean，导致你的MockBean根本没被JPA审计逻辑用到。
3. 测试类中注入的Clock没有定义，也是潜在的问题点。

修复方案 #

方案一：精准Mock指定名称的DateTimeProvider #

不需要自定义TestDateTimeProvider，直接让MockBean覆盖JPA审计依赖的指定名称Bean：

@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
@TestExecutionListeners({ DependencyInjectionTestExecutionListener.class,
        DbUnitTestExecutionListener.class })
@DatabaseSetup("data.xml")
@DatabaseTearDown("data.xml")
@EnableJpaAuditing(dateTimeProviderRef = "testDateTimeProvider")
public class MessageServiceTest {
    // 定义固定时钟，生成预期时间
    private final Clock fixedClock = Clock.fixed(Instant.parse("2023-09-22T17:00:00.00Z"), ZoneId.of("UTC"));
    
    @Autowired
    MessagesService messagesService;

    // 指定MockBean的名称与JPA审计配置的ref一致
    @MockBean(name = "testDateTimeProvider")
    private DateTimeProvider dateTimeProvider;

    @Test
    public void testSaveNewMessage()
    {
        LocalDateTime expectedCreate = LocalDateTime.now(fixedClock);
        // 让Mock返回固定时间
        Mockito.when(dateTimeProvider.getNow()).thenReturn(Optional.of(expectedCreate));
        
        Message actual = messagesService.saveMessage("abc", 123);
        
        assertNotNull(actual);
        assertThat(actual.getCreateDate()).isEqualToIgnoringNanos(expectedCreate);
    }
}

方案二：用测试配置类替换DateTimeProvider #

如果需要复用固定时间的Provider，可以编写测试专属配置类：

1. 编写测试配置类

@TestConfiguration
public class TestAuditConfig {
    @Bean("testDateTimeProvider")
    public DateTimeProvider fixedDateTimeProvider() {
        Clock fixedClock = Clock.fixed(Instant.parse("2023-09-22T17:00:00.00Z"), ZoneId.of("UTC"));
        return () -> Optional.of(LocalDateTime.now(fixedClock));
    }
}

2. 修改测试类，导入配置并移除MockBean

@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
@TestExecutionListeners({ DependencyInjectionTestExecutionListener.class,
        DbUnitTestExecutionListener.class })
@DatabaseSetup("data.xml")
@DatabaseTearDown("data.xml")
@Import(TestAuditConfig.class)
@EnableJpaAuditing(dateTimeProviderRef = "testDateTimeProvider")
public class MessageServiceTest {
    private final Clock fixedClock = Clock.fixed(Instant.parse("2023-09-22T17:00:00.00Z"), ZoneId.of("UTC"));
    
    @Autowired
    MessagesService messagesService;

    @Test
    public void testSaveNewMessage()
    {
        LocalDateTime expectedCreate = LocalDateTime.now(fixedClock);
        Message actual = messagesService.saveMessage("abc", 123);
        
        assertNotNull(actual);
        assertThat(actual.getCreateDate()).isEqualToIgnoringNanos(expectedCreate);
    }
}

关键注意事项 #

• @MockBean默认替换同类型Bean，但如果目标Bean是指定名称的，必须给@MockBean加上name属性才能精准替换，否则会出现Bean冲突。
• 不要同时导入真实Bean和声明MockBean，这会让Spring容器的注入逻辑混乱。
• 测试时的预期时间要和Mock/固定的时间完全匹配，避免时区或精度差异导致断言失败。

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