Spring测试用H2内存数据库无法创建表的解决求助

问题背景 #

Spring版本从2.6.14升级到2.7.7后，测试环境使用的H2内存数据库无法正常创建表。实体类中使用了MySQL风格的columnDefinition（如INT(11) UNSIGNED），此前在2.6.14版本下无异常。报错显示H2新版本不兼容这类MySQL语法，已尝试配置MODE=MYSQL及spring.jpa.database-platform=org.hibernate.dialect.MySQL8Dialect，且确认配置文件已加载，但问题仍存在。

核心原因 #

Spring 2.7.x默认升级了H2数据库至2.x版本，该版本对MySQL兼容模式的语法校验更严格。即使开启MODE=MYSQL，部分MySQL特有的语法细节（如INT(11)的长度标注、UNSIGNED关键字的解析）仍不被原生支持，同时Hibernate会原样输出实体类中columnDefinition的内容，导致H2解析DDL时抛出语法错误。

无需修改实体类的解决方案 #

方案1：优化H2连接URL参数 #

在连接URL中添加MYSQL_COMPATIBILITY=TRUE开启完整MySQL语法兼容，配合其他兼容参数，修改后的配置如下：

spring.datasource.url=jdbc:h2:mem:db;DB_CLOSE_DELAY=-1;MODE=MYSQL;MYSQL_COMPATIBILITY=TRUE;DATABASE_TO_LOWER=TRUE;DEFAULT_NULL_ORDERING=HIGH

• MYSQL_COMPATIBILITY=TRUE：开启H2对MySQL语法的完整兼容，支持INT(11) UNSIGNED这类写法
• DATABASE_TO_LOWER=TRUE：将表名、列名转为小写，适配MySQL的大小写规则
• DEFAULT_NULL_ORDERING=HIGH：对齐MySQL中NULL值的排序规则

方案2：调整Hibernate方言配置 #

改用H2原生方言并指定存储引擎为InnoDB，同时添加Hibernate适配参数：

spring.jpa.database-platform=org.hibernate.dialect.H2Dialect
spring.jpa.properties.hibernate.dialect.storage_engine=innodb
spring.jpa.properties.hibernate.hbm2ddl.delimiter=;
spring.jpa.properties.hibernate.format_sql=true

该配置让Hibernate生成更适配H2 MySQL模式的DDL语句，避免语法冲突。

方案3：降级H2版本至旧兼容版 #

如果上述方案无效，可强制将H2版本降级至Spring 2.6.x默认的1.4.200版本，直接兼容原有语法。在pom.xml中添加：

<dependency>
    <groupId>com.h2database</groupId>
    <artifactId>h2</artifactId>
    <version>1.4.200</version>
    <scope>test</scope>
</dependency>

验证步骤 #

1. 应用上述任意一种配置后，启动测试环境
2. 访问H2控制台（默认路径/h2-console），检查users等表是否成功创建
3. 执行原有测试用例，确认数据增删改查操作正常

内容的提问来源于stack exchange，提问作者sineverba