repository层数据库集成测试需连接真实数据库（如h2或testcontainers），验证sql、字段映射、jpa查询及事务行为；@datajpatest提供轻量上下文与自动回滚，@sql支持数据初始化，testcontainers用于覆盖h2无法模拟的数据库特性。
它不是“能不能编译通过”的测试，而是验证“SQL 写对了没、字段映射准不准、JPA 查询逻辑是否生效、事务行为是否符合预期”。这类测试必须连接数据库，但不用连生产库——用轻量、隔离、自动清理的方案即可。
用 @DataJpaTest 启动最小 JPA 上下文
这是 Spring Boot 专为 Repository 测试设计的注解，它会：
- 自动配置一个内存数据库（默认 H2），无需手动写 datasource 配置
- 只加载 JPA 相关 Bean（EntityManager、Repository 实现等），不启动 Web 层或 Service，速度快、干扰少
- 默认每个测试方法运行在独立事务中，并自动回滚，数据天然隔离
示例代码中，你只需注入 Repository 和 EntityManager，用 entityManager.persist() 插入测试数据，再调用 Repository 方法查询，断言结果即可。不需要 @Transactional 或手动 flush —— @DataJpaTest 已为你封装好这些细节。
确保 SQL 和实体真正对得上
很多团队漏掉这一步：只测接口返回，不测底层 SQL 是否命中正确字段。比如把 @Column(name = "nick_name") 写成 "nickname"，或新增字段没加 @Transient 导致插入失败，Mock 测试完全发现不了。
- 在测试里显式构造实体并 save，再 findById 或自定义查询，检查返回对象所有字段值
- 开启 Hibernate 的
spring.jpa.show-sql=true和spring.jpa.format-sql=true，看控制台输出的 SQL 是否符合预期 - 对复杂 JPQL 或 @Query 方法，额外加一条测试：手写等价原生 SQL，在 H2 中直接执行比对结果
需要更真实？换 Testcontainers 连真实数据库
当 H2 不足以覆盖行为时（比如 PostgreSQL 的 jsonb 类型、MySQL 的严格模式、特定索引优化），就该上 Testcontainers。
- 用
@Container static PostgreSQLContainer声明一个临时 Docker 实例，每次测试启动新容器 - 配合
@SpringBootTest+ 自定义application-testcontainers.properties指向容器地址 - 适合验证分页性能、锁机制、批量操作、外键约束等 H2 模拟不到的场景
注意：Testcontainers 测试应放在 integration 目录下，用 Maven 的 failsafe 插件单独执行，避免拖慢日常单元测试流程。
别跳过数据初始化和清理逻辑
有些 Repository 方法依赖预置数据（如字典表、状态枚举），不能靠“空库跑一次就完事”。
- 用
@Sql注解在测试方法前后执行 SQL 脚本，比如@Sql("/sql/init_user.sql") - 脚本路径放在
src/test/resources/sql/下，内容可含 INSERT、UPDATE，支持多条语句 - 若需全局初始化，可在测试类上加
@TestInstance(TestInstance.Lifecycle.PER_CLASS)，配合@BeforeAll统一准备
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
