使用 @datajpatest 测试持久层时,spring boot 会自动配置一个嵌入式数据库(默认 h2)并扫描 @entity 类,同时仅加载 jpa 相关的 bean。这种做法隔离了 service 和 controller 层,确保测试只关注数据访问逻辑。通过注入 jdbctemplate 或 repository 接口,可以直接操作数据库验证 crud 行为。

@DataJpaTest 自动配置了哪些组件?
@DataJpaTest 会启用 JpaAutoConfiguration,这意味着它会自动创建 EntityManagerFactory 和 TransactionManager。默认情况下,它会使用内存中的 H2 数据库,除非项目中没有 H2 依赖而 fallback 到 Derby。此外,它还会扫描带有 @Entity 注解的类,并注册带有 @Repository 注解的 Bean。需要注意的是,它不会加载 @Service 或 @Controller 等全栈 Bean,从而实现了轻量级测试。

import org.springframework.boot.test.autoconfigure.orm.jpa.DataJpaTest;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.test.context.junit.jupiter.SpringExtension;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;
import static org.assertj.core.api.Assertions.assertThat;
@ExtendWith(SpringExtension.class)
@DataJpaTest
public class UserRepositoryIntegrationTest {
@Autowired
private UserRepository userRepository;
@Autowired
private JdbcTemplate jdbcTemplate;
@Test
public void whenSaveUser_thenCountIsOne() {
// 1. 准备数据:直接插入一条记录
jdbcTemplate.execute("INSERT INTO users (name, email) VALUES ('Alice', 'alice@test.com')");
// 2. 执行查询:通过 Repository 查找
var user = userRepository.findByEmail("alice@test.com");
// 3. 验证结果
assertThat(user).isNotNull();
assertThat(user.getName()).isEqualTo("Alice");
}
}
上述代码展示了如何结合 JdbcTemplate 初始化测试数据,并利用 UserRepository 进行业务验证。这种组合方式既利用了 Spring 的事务管理,又保证了数据的独立性。
如何测试自定义 Query 方法?
在测试自定义 JPQL 或原生 SQL 查询时,关键在于确保实体映射与数据库表结构一致。如果使用了 @Query 注解,需要验证其返回的对象是否正确映射了字段。对于复杂查询,建议先检查生成的 SQL 语句是否符合预期,再验证返回的数据集。可以通过 assertThat 库对列表大小、元素属性进行断言。若查询涉及分页,需验证 Page 对象的总页数和当前页内容。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。

import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.data.domain.Page;
import org.springframework.data.domain.PageRequest;
import static org.assertj.core.api.Assertions.assertThat;
// ... 保持之前的 @DataJpaTest 类定义 ...
@Test
public void whenFindByNameContaining_thenReturnsMatchingUsers() {
// 插入多条测试数据
jdbcTemplate.execute("INSERT INTO users (name, email) VALUES ('Bob', 'bob@test.com')");
jdbcTemplate.execute("INSERT INTO users (name, email) VALUES ('Charlie', 'charlie@test.com')");
// 执行模糊查询
Page<user> page = userRepository.findByNameContaining("o", PageRequest.of(0, 10));
// 验证结果
assertThat(page.getContent()).hasSize(1);
assertThat(page.getContent().get(0).getName()).isEqualTo("Bob");
}</user>
此示例演示了如何使用 PageRequest 进行分页查询测试。通过插入特定数据并调用自定义查询方法,可以验证 LIKE 查询的行为是否符合预期。注意 page.getContent() 返回的是当前页的数据列表,而非全部匹配结果。
事务回滚在测试中是如何工作的?
@DataJpaTest 默认启用了事务管理,并在每个测试方法结束后自动回滚。这意味着即使你在测试中修改了数据库数据,也不会影响后续测试或生产环境。如果需要测试事务边界或提交行为,可以使用 @Rollback(false) 注解来禁用自动回滚。但在大多数情况下,保持默认的回滚行为是最佳实践,因为它确保了测试的隔离性和可重复性。若需验证外键约束或唯一索引冲突,可以在不回滚的事务中故意插入重复数据,观察是否抛出异常。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










