Spring Boot用户保存功能集成测试失败排查求助

你的测试类中使用了@MockBean修饰UserRepository，这会将Spring容器中的真实Repository实例替换为Mockito模拟对象。默认情况下，模拟对象的所有方法调用都不会执行实际逻辑（比如真实的数据库存储/查询），所以调用userService.save(TEST_USER)后，userRepository.findByEmail()自然返回空的Optional，导致断言失败。

同时，@ContextConfiguration(classes = {UserServiceImpl.class})仅加载了Service类的上下文，没有完整加载Spring Boot的JPA、数据库配置等核心组件，即使去掉MockBean，也可能无法正确连接H2数据库。

根据你的需求，分两种场景处理：

场景1：集成测试（使用真实H2数据库） #

如果要验证用户是否真的存入数据库，需要使用真实的Repository和H2数据库：

1. 移除模拟对象：删除测试类中的@MockBean private UserRepository userRepository，让Spring自动注入真实的Repository实例。
2. 修正上下文配置：删除@ContextConfiguration(classes = {UserServiceImpl.class})，@SpringBootTest会自动加载完整的应用上下文，包括H2数据库配置。
3. 添加事务控制（可选）：给测试方法添加@Transactional，测试结束后自动回滚数据，避免污染后续测试。
4. 确保实体映射正确：检查User和Role类的JPA注解（比如@ManyToMany、@Id等）是否配置正确，否则H2无法生成对应的表结构。

修正后的测试类示例：

@SpringBootTest
@TestPropertySource("/application-test.properties")
public class UserServiceImplTest {

    private static final Long TEST_ID = 123L;
    public static final User TEST_USER;
    public static final String TEST_USER_NAME = "Ivan";
    public static final String TEST_USER_EMAIL = "test@email.com";
    public static final String TEST_PASSWORD = "1234";
    public static final Role TEST_USER_ROLE;
    public static final Set<Role> TEST_ROLES;
    private static final List<User> TEST_USER_LIST;

    static {
        TEST_USER_LIST = new ArrayList<>();
        TEST_USER_ROLE = Role.builder()
                .name("ROLE_USER")
                .build();
        TEST_ROLES = Set.of(TEST_USER_ROLE);
        TEST_USER = User.builder()
                .name(TEST_USER_NAME) // 移除手动设置的id，让数据库自动生成
                .email(TEST_USER_EMAIL)
                .password(TEST_PASSWORD)
                .roles(TEST_ROLES)
                .build();
        TEST_USER_LIST.add(TEST_USER);
    }

    @Autowired
    private UserService userService;

    @Autowired
    private UserRepository userRepository;

    @Test
    @DisplayName("Add user in database test")
    @Transactional
    void addUserInDatabaseTest() {
        userService.save(TEST_USER);
        Optional<User> savedUser = userRepository.findByEmail(TEST_USER.getEmail());
        
        assertThat(savedUser).isPresent();
        assertThat(savedUser.get().getEmail()).isEqualTo(TEST_USER.getEmail());
        // 注意：如果User类重写了equals方法，可以直接比较对象，否则比较关键属性
    }
}

场景2：单元测试（仅测试Service逻辑，无需真实数据库） #

如果只是测试Service的业务逻辑，不需要真实数据库，可以保留MockBean，但需要模拟Repository的行为：

1. 保留MockBean：继续使用@MockBean private UserRepository userRepository。
2. 模拟Repository方法：在测试方法中，用Mockito指定Repository方法的返回结果。

修正后的测试方法示例：

@Test
@DisplayName("Add user in database test")
void addUserInDatabaseTest() {
    // 模拟save方法返回测试用户
    when(userRepository.save(any(User.class))).thenReturn(TEST_USER);
    // 模拟findByEmail方法返回测试用户
    when(userRepository.findByEmail(TEST_USER.getEmail())).thenReturn(Optional.of(TEST_USER));

    userService.save(TEST_USER);
    Optional<User> savedUser = userRepository.findByEmail(TEST_USER.getEmail());
    
    assertThat(savedUser).isPresent();
    assertThat(savedUser.get()).isEqualTo(TEST_USER);
}

• 确保application-test.properties放在src/test/resources目录下，测试时Spring能正确加载。
• 检查H2依赖的scope：当前runtime范围在测试环境下是有效的，无需修改。
• 如果是集成测试，确保UserService的save方法确实调用了userRepository.save()，没有被其他逻辑拦截。

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