Java 中怎么在单元测试中启动内嵌 H2 内存数据库

雨婷吖_4216

雨婷吖_4216

2026-09-29

708人浏览

原创

最常用且推荐的方式是通过 spring boot 的 @datajpatest 自动配置 h2 内存数据库,自动创建数据源、建表并加载 sql 脚本;也可通过 application-test.properties 自定义连接参数与初始化行为,或手动构建 datasource 用于无 spring 场景。

java 中怎么在单元测试中启动内嵌 h2 内存数据库

在 Java 单元测试中启动内嵌 H2 内存数据库,最常用且推荐的方式是通过 Spring Boot 的测试支持(@SpringBootTest 或 @DataJpaTest)自动配置 H2,配合 application-test.properties 或 @TestConfiguration 显式声明数据源。无需手动 new DataSource 或启动 H2 服务,Spring 会自动完成初始化和 Schema/SQL 加载。

使用 @DataJpaTest 快速启用 H2 内存库

这是轻量级、专注 JPA 层测试的推荐方式,Spring Boot 会自动:

  • 配置一个内存版 H2 数据源(jdbc:h2:mem:testdb)
  • 启用 spring.jpa.hibernate.ddl-auto=create-drop,每次测试后自动重建表
  • 扫描 @Entity 类并创建对应表结构
  • 加载 schema.sql 和 data.sql(若存在)

示例测试类:

@DataJpaTest
class UserRepositoryTest {

    @Autowired
    private TestEntityManager entityManager;

    @Autowired
    private TestRepository repository;

    @Test
    void should_save_and_find_user() {
        User user = new User("Alice");
        entityManager.persistAndFlush(user);
        assertThat(repository.findById(user.getId())).isPresent();
    }
}

自定义 H2 连接参数与初始化脚本

若需控制数据库名、关闭自动建表、或执行特定 SQL,可在 src/test/resources/application-test.properties 中配置:

spring.datasource.url=jdbc:h2:mem:mytest;DB_CLOSE_DELAY=-1;DB_CLOSE_ON_EXIT=FALSE
spring.datasource.driver-class-name=org.h2.Driver
spring.jpa.database-platform=org.hibernate.dialect.H2Dialect
spring.jpa.hibernate.ddl-auto=none
spring.sql.init.mode=always
spring.sql.init.schema-locations=classpath:schema-test.sql
spring.sql.init.data-locations=classpath:data-test.sql

注意:DB_CLOSE_DELAY=-1 防止多个测试间连接被意外关闭;spring.sql.init.mode=always 确保每次测试前重新执行 SQL 脚本。

deep-java-review
deep-java-review

Java项目代码review工具。分析Git变更+完整调用链路上下文,推断业务需求,进行多维度评分和分类汇总,生成完整PRD文档。包含细粒度Java代码审查清单(Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...

下载

纯 JUnit + H2(不依赖 Spring)

如需完全脱离 Spring 容器(例如测试 DAO 工具类),可手动构建 HikariDataSource 或 DriverManagerDataSource:

@Test
void testWithPlainH2() throws SQLException {
    String url = "jdbc:h2:mem:testdb;DB_CLOSE_DELAY=-1";
    DataSource ds = new DriverManagerDataSource(url, "sa", "");

    // 手动建表(可用 ScriptRunner 或 executeUpdate)
    try (Connection conn = ds.getConnection();
         Statement stmt = conn.createStatement()) {
        stmt.execute("CREATE TABLE users(id BIGINT AUTO_INCREMENT PRIMARY KEY, name VARCHAR(50))");
        stmt.execute("INSERT INTO users(name) VALUES ('Bob')");
    }

    // 执行查询验证...
}

这种方式灵活但需自行管理生命周期和 SQL 初始化,适合极简场景或教学演示。

避免常见陷阱

以下问题在实际中高频出现:

  • H2 URL 缺少 ;DB_CLOSE_DELAY=-1 → 多个 @Test 方法间数据库被清空
  • 误用 jdbc:h2:mem: 不带数据库名(如 jdbc:h2:mem:) → 每次连接都是全新独立内存库,无法共享数据
  • 未设置 spring.sql.init.mode → Spring Boot 2.5+ 默认禁用 SQL 初始化,schema.sql 不再自动执行
  • 混合使用 @SpringBootTest 和 @DataJpaTest → 前者加载全上下文,后者更轻量;按需选择,勿叠加

不复杂但容易忽略。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

java

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

9277

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

6442

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

5752

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1024

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

848

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1216

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2449

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

19791

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1095

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习