SpringBoot Mybatis H2 自测环境搭建

2026-11-22 Sunday

运行单元案例时是否使用数据库访问往往需要进行取舍。

案例访问真实数据库里的数据往往比较耗时,而且容易受到数据库已有数据的影响,导致断言无法通过。

如果直接Mock所有数据库的访问,则无法验证SQL部分的逻辑。

最近发现H2数据库可以很好得解决这一矛盾。

查阅了网上一些资料,总结了一下。目标是以最小的改动快速实现测试代码访问H2数据库。

使用方法

1. 搭建或打开已有的Spring项目

项目需要满足以下条件

  • 项目使用Maven等工具管理(源码和测试案例分离)
  • 数据库配置在application.properties里
  • 树据源Driver使用变量配置

2. 添加H2数据库依赖

以Maven项目为例,在项目的pom.xml里添加H2的依赖。

注意版本号可以根据需要替换。添加<scope>test</scope>避免生产环境带出。

<!-- https://mvnrepository.com/artifact/com.h2database/h2 -->
<dependency>
    <groupId>com.h2database</groupId>
    <artifactId>h2</artifactId>
    <version>1.4.197</version>
    <scope>test</scope>
</dependency>
1
2
3
4
5
6
7

3. 准备好DDL和DML语句

把DDL和DML放入脚本用于生成H2表和相关测试数据

由于H2DB并不兼容所有的数据库的DDL语法,建议从真实数据库环境导出DDL语句后,先在H2 Web Client 里跑一下,通过后再写入测试用的Sql脚本文件里。

提取好可用的DDL和DML后,把文件保存到src/test/resources的子目录下,例如 src/test/resources/scripts/db.sql

注意

有些表是带Schema前缀访问的,所以在保存的脚本最前加入Schema创建语句,避免后续进行DML操作时报Schema不存在。

已知的不兼容情况

  • 注释:不支持表级别的Comment
  • 索引:H2中的索引是数据库内唯一,MySQL中的索引是每张表唯一
  • CURRENT_TIMESTAMP:H2不支持记录更新时自动刷新字段时间,也就是不支持语句ON UPDATE CURRENT_TIMESTAMP
  • JSON:H2不兼容MySqlJSON字段类型,建议换成longtext
  • 双引号转义:H2不兼容双引号转义\",直接写"即可(在插入JSON 字符串时注意)

4. 配置单元案例的数据源

  • 拷贝application.properties到src/test/resources目录
  • 修改数据源配置 例如:
#h2
jdbc.driverClassName = org.h2.Driver
jdbc.url= jdbc:h2:mem:testdb;MODE=MYSQL;INIT=RUNSCRIPT FROM 'classpath:scripts/db.sql';DB_CLOSE_DELAY=-1
jdbc.username =root
jdbc.password =123456
1
2
3
4
5

  • 这里用户名,密码可以随意写,不要留空。
  • Schema建议跟实际环境保持一致(示例代码里是testdb)。
  • INIT=RUNSCRIPT FROM后跟的是步骤3里保存的SQL脚本路径,因为脚本保存在src/test/resources目录下,所以直接用classpath:开头即可;
  • MODE建议写H2兼容比较好的MYSQL,如果使用的是Oracle数据库,也建议配置成MYSQL,建表语句是可以兼容的。

附录

参考资料:

最近更新: 2026-11-22 17:33:40