禁用数据库自动配置时Spring Boot测试Mock Repository失效问题

你禁用了HibernateJpaAutoConfiguration后，JpaRepositoriesAutoConfiguration仍在生效，Spring会自动扫描所有@Repository接口（包括BookRepository）并尝试创建代理Bean，但此时缺少JPA核心的EntityManagerFactory，导致Bean创建失败。同时你仅Mock了ReaderRepository，未处理BookRepository的依赖，因此触发报错。

以下两种方案均能实现轻量化全流程测试，无需连接真实数据库或使用Testcontainer：

方案一：使用@WebMvcTest（推荐，极致轻量化） #

@WebMvcTest专门用于测试Controller层，仅加载Web相关组件，配合@MockBean模拟Repository、@Import导入真实Service，既保证全流程测试的真实性，又能大幅提升测试速度。

@WebMvcTest(ReaderController.class) // 仅加载ReaderController相关的Web组件
@Import(ReaderServiceImpl.class)    // 导入真实的ReaderService实现，保留Controller→Service的真实逻辑
public class ReaderControllerTest {

  @Autowired
  private MockMvc mockMvc;

  @MockBean
  private ReaderRepository readerRepository; // Mock Repository，完全隔离真实数据库

  @Test
  void createUserTest() throws Exception {
    // 构造预期返回的Reader对象
    var expectedReader = new Reader();
    expectedReader.setName("user");
    expectedReader.setEmail("user@email.com");

    // Mock Repository的save方法，匹配任意Reader参数并返回预期值
    Mockito.when(readerRepository.save(Mockito.any(Reader.class))).thenReturn(expectedReader);

    // 发送POST请求并验证响应
    mockMvc.perform(
            post("/user")
                .contentType(MediaType.APPLICATION_JSON)
                .content("{\"name\": \"test\", \"email\": \"test@email.com\"}") // 传入符合接口要求的请求体
        )
        .andExpect(status().isOk())
        .andExpect(jsonPath("$.name").value("user")) // 验证响应中的name字段
        .andExpect(jsonPath("$.email").value("user@email.com")); // 验证响应中的email字段
  }
}

方案二：缩小@SpringBootTest的组件扫描范围 #

如果需要加载更多Spring上下文但仍保持轻量化，可指定仅扫描Reader相关组件，同时排除所有数据库相关自动配置：

@SpringBootTest
// 仅扫描Reader相关的Controller和Service组件，避免加载无关的BookController等
@ComponentScan(basePackages = {
    "com.example.demo.controller.reader",
    "com.example.demo.service.reader"
})
// 排除所有数据库和JPA相关的自动配置，彻底避免连接真实DB
@EnableAutoConfiguration(exclude = {
    DataSourceAutoConfiguration.class,
    JpaRepositoriesAutoConfiguration.class,
    HibernateJpaAutoConfiguration.class
})
public class ReaderControllerTest {

  @Autowired
  private MockMvc mockMvc;

  @MockBean
  private ReaderRepository readerRepository;

  @Test
  void createUserTest() throws Exception {
    var expectedReader = new Reader();
    expectedReader.setName("user");
    expectedReader.setEmail("user@email.com");

    Mockito.when(readerRepository.save(Mockito.any(Reader.class))).thenReturn(expectedReader);

    mockMvc.perform(
            post("/user")
                .contentType(MediaType.APPLICATION_JSON)
                .content("{\"name\": \"test\", \"email\": \"test@email.com\"}")
        )
        .andExpect(status().isOk())
        .andExpect(jsonPath("$.name").value("user"))
        .andExpect(jsonPath("$.email").value("user@email.com"));
  }
}

1. 修正Mock匹配规则：不要用save(null)，而是用Mockito.any(Reader.class)匹配任意传入的Reader对象，否则Mock逻辑不会触发。
2. 请求体完整性：确保请求JSON包含Controller所需的字段，避免因参数缺失导致的业务错误。
3. 响应验证：添加jsonPath验证响应payload的字段值，确保全流程逻辑符合预期。

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