SpringBootTest中跳过数据库配置实现Mock数据库调用的方法

一、彻底排除数据库相关自动配置类 #

之前排除无效大概率是因为没覆盖全所有数据库相关的自动配置项，需要根据你使用的数据库技术（JDBC/JPA/MyBatis等）精准排除：

@SpringBootTest
@EnableAutoConfiguration(exclude = {
    DataSourceAutoConfiguration.class,
    DataSourceTransactionManagerAutoConfiguration.class,
    JdbcTemplateAutoConfiguration.class,
    HibernateJpaAutoConfiguration.class, // 用JPA时需加
    JpaRepositoriesAutoConfiguration.class, // Spring Data JPA仓库自动配置
    MybatisAutoConfiguration.class // 用MyBatis时需加
})
public class YourIntegrationTest {
    // 测试逻辑
}

这样能直接阻止Spring Boot自动创建数据源、事务管理器等组件，从根源上避免真实数据库连接尝试。

二、用@TestConfiguration替换依赖的数据库Bean #

如果业务层依赖JdbcTemplate、Repository等数据库相关Bean，排除自动配置后会出现Bean缺失，可在测试类内自定义配置提供Mock实例：

@SpringBootTest
@EnableAutoConfiguration(exclude = { /* 上述数据库配置类 */ })
public class YourIntegrationTest {

    @TestConfiguration
    static class TestDbConfig {
        // Mock JdbcTemplate供业务层调用
        @Bean
        public JdbcTemplate jdbcTemplate() {
            return Mockito.mock(JdbcTemplate.class);
        }

        // Mock自定义Repository接口
        @Bean
        public UserRepository userRepository() {
            return Mockito.mock(UserRepository.class);
        }
    }

    @Autowired
    private UserService userService;

    @Test
    void testUserQuery() {
        // 预设Mock返回值
        Mockito.when(userRepository.findById(1L)).thenReturn(Optional.of(new User(1L, "testUser")));
        
        // 调用业务方法并断言结果
        User result = userService.getUserById(1L);
        Assertions.assertEquals("testUser", result.getName());
    }
}

三、用@MockBean直接替换真实DAO/Repository #

不想手动配置Bean的话，Spring Boot Test提供的@MockBean可以自动替换容器中的真实数据库层Bean，配合自动配置排除使用更高效：

@SpringBootTest
@EnableAutoConfiguration(exclude = { /* 数据库配置类 */ })
public class YourIntegrationTest {

    @MockBean
    private UserRepository userRepository; // 自动替换容器内的真实Repository

    @Autowired
    private UserService userService;

    @Test
    void testUserCreation() {
        // 配置Mock行为
        Mockito.when(userRepository.save(Mockito.any(User.class)))
               .thenReturn(new User(2L, "newUser"));
        
        User savedUser = userService.createUser("newUser");
        Assertions.assertEquals(2L, savedUser.getId());
    }
}

四、跳过配置文件中的数据库配置 #

如果测试仍会读取主配置文件的数据库参数，可在src/test/resources下创建测试专属配置文件，覆盖或置空数据库配置：
比如src/test/resources/application-test.yml：

spring:
  datasource:
    url: jdbc:h2:mem:mockdb # 用内存库占位，或直接设为无效值
    driver-class-name: org.h2.Driver
    username: sa
    password:
  jpa:
    hibernate:
      ddl-auto: none # 禁止自动建表

然后测试类指定使用该配置：

@SpringBootTest
@ActiveProfiles("test")
@EnableAutoConfiguration(exclude = { /* 数据库配置类 */ })
public class YourIntegrationTest {
    // ...
}

排查要点 #

• 检查是否有自定义的数据库配置类（比如手动创建DataSource的配置）未被测试排除，可给这类配置加@Profile("prod")，测试时不激活该Profile。
• 确认排除的自动配置类与你使用的数据库技术匹配，比如用MyBatis就必须排除MybatisAutoConfiguration.class。
• 避免使用@DataJpaTest这类专项测试注解，它们会强制加载数据库配置，改用@SpringBootTest配合排除配置更稳妥。

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