SpringBoot Mybatis H2 自测环境搭建
Hz 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
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不兼容MySql
JSON字段类型,建议换成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
2
3
4
5
- 这里用户名,密码可以随意写,不要留空。
- Schema建议跟实际环境保持一致(示例代码里是testdb)。
INIT=RUNSCRIPT FROM后跟的是步骤3里保存的SQL脚本路径,因为脚本保存在src/test/resources目录下,所以直接用classpath:开头即可;- MODE建议写H2兼容比较好的MYSQL,如果使用的是Oracle数据库,也建议配置成MYSQL,建表语句是可以兼容的。
附录
参考资料: