SpringBootTest集成测试：如何持久化实体？RestController测试实体不可见问题

兄弟，我太懂这种抓耳挠腮的感觉了！之前做Spring Boot集成测试的时候也踩过一模一样的坑——明明测试里已经把实体存进去了，调试的时候上下文里能看到，可Controller就是找不到，404测试倒是能过，但正常查询/创建验证就是失败。咱们来拆解一下问题，再给你几个靠谱的解决办法：

核心问题：事务与持久化上下文的隔离 #

大部分情况下，这个问题都是事务边界和JPA持久化上下文缓存导致的：

1. Spring Boot集成测试默认会给测试方法加上@Transactional注解，测试结束后自动回滚事务。如果你用MockMvc，默认是和测试方法共享同一个事务，但JPA的save()方法默认只是把实体放到内存的持久化上下文里，并没有立刻写入数据库；如果用TestRestTemplate发起真实HTTP请求，Controller的请求会在另一个独立事务里，根本看不到测试事务里未提交的实体。
2. 就算实体已经写入数据库，持久化上下文的一级缓存也会让Controller的查询优先从缓存取（如果是同一个事务的话），但测试里的实体和Controller里的上下文可能不是同一个缓存实例。

解决方案一：手动刷新EntityManager（针对MockMvc场景） #

如果用MockMvc做测试，在保存实体后，强制把持久化上下文的内容刷入数据库，并清空缓存，这样Controller就能读到真实的数据库数据了：

@SpringBootTest
@AutoConfigureMockMvc
class UserControllerIntegrationTest {

    @Autowired
    private MockMvc mockMvc;

    @Autowired
    private UserRepository userRepo;

    @Autowired
    private EntityManager entityManager;

    @Test
    void shouldReturnCreatedEntity() throws Exception {
        // 1. 创建并保存实体
        User testUser = new User("Jack", "jack@example.com");
        User savedUser = userRepo.save(testUser);

        // 2. 关键步骤：刷入数据库+清空缓存
        entityManager.flush(); // 强制将持久化上下文的变更同步到DB
        entityManager.clear(); // 清空缓存，避免后续查询从内存取

        // 3. 调用Controller验证
        mockMvc.perform(get("/users/{id}", savedUser.getId()))
                .andExpect(status().isOk())
                .andExpect(jsonPath("$.name").value("Jack"));
    }

    @Test
    void shouldReturn404ForNonExistentEntity() throws Exception {
        mockMvc.perform(get("/users/99999"))
                .andExpect(status().isNotFound());
    }
}

解决方案二：分离事务（针对TestRestTemplate场景） #

如果用TestRestTemplate发起真实HTTP请求，因为Controller运行在独立事务里，测试方法的事务未提交的话，Controller根本看不到数据。这时候可以用TransactionTemplate把实体保存操作放到独立事务里并提交：

@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
class UserControllerRealRequestTest {

    @Autowired
    private TestRestTemplate restTemplate;

    @Autowired
    private UserRepository userRepo;

    @Autowired
    private TransactionTemplate transactionTemplate;

    @Test
    void shouldFetchSavedEntityViaRest() {
        // 1. 在独立事务中保存并提交实体
        User savedUser = transactionTemplate.execute(status -> {
            User user = new User("Jack", "jack@example.com");
            return userRepo.save(user);
        });

        // 2. 发起真实HTTP请求
        ResponseEntity<User> response = restTemplate.getForEntity(
                "/users/{id}", User.class, savedUser.getId()
        );

        // 3. 验证结果
        assertThat(response.getStatusCode()).isEqualTo(HttpStatus.OK);
        assertThat(response.getBody().getEmail()).isEqualTo("jack@example.com");
    }
}

解决方案三：调整测试事务策略（慎用） #

你也可以给测试方法加上@Rollback(false)，让测试结束后不回滚事务，但这样会污染测试数据库，需要在@AfterEach里手动清理数据：

@Test
@Rollback(false)
void testEntityPersistence() throws Exception {
    User testUser = userRepo.save(new User("Jack"));
    // ... 测试逻辑 ...
}

@AfterEach
void cleanUp() {
    userRepo.deleteAll();
}

避坑提醒 #

• 不要混用@DataJpaTest和@SpringBootTest：@DataJpaTest是针对JPA层的切片测试，不会加载完整的Web上下文，用来做RestController集成测试肯定出问题。
• 确认你的Repository方法是正确的：比如save()是否真的返回了持久化后的实体（带ID），避免因为Repository配置错误导致实体没真正保存。
• 如果用了H2内存数据库，确认URL配置了DB_CLOSE_DELAY=-1，避免数据库连接关闭导致数据丢失。

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