咱们先从H2和MySQL的核心差异入手，毕竟这俩数据库的语法细节、约束检查逻辑经常会导致这种“MySQL跑通但H2报错”的情况，一步步来排查：

1. 先确认H2的MySQL兼容模式是否开启 #

这是最常见的坑！H2默认的模式和MySQL差异很大，你需要在连接URL里明确指定兼容模式，同时处理大小写问题（MySQL默认表名/列名不区分大小写，H2默认区分）。

比如把你的H2连接URL改成这样：

jdbc:h2:mem:testdb;MODE=MySQL;DATABASE_TO_LOWER=TRUE;CASE_INSENSITIVE_IDENTIFIERS=TRUE;DB_CLOSE_DELAY=-1

• MODE=MySQL：让H2尽可能模拟MySQL的语法和行为
• DATABASE_TO_LOWER=TRUE：把所有表名/列名转成小写，和MySQL默认行为对齐
• CASE_INSENSITIVE_IDENTIFIERS=TRUE：确保标识符大小写不敏感

2. 检查SQL脚本的执行顺序是否符合外键依赖 #

虽然MySQL能正常执行，但H2的外键约束检查可能更严格。你要确认：

• 建表顺序：先创建父表（被引用的表），再创建子表（引用父表的表）
• 插入数据顺序：先插父表的基础数据，再插子表的关联数据

比如如果你的脚本里先插了订单表（子表），再插用户表（父表），H2会直接触发外键约束失败，而MySQL可能因为约束检查时机的差异（比如事务提交时才检查）没报错。

3. 核对数据类型和主键生成策略的兼容性 #

有些MySQL的语法在H2里需要特殊处理：

• 主键自增：MySQL用AUTO_INCREMENT，H2在兼容模式下支持，但如果脚本里用了SERIAL或者其他MySQL特有语法，要确认H2是否能识别
• 数据类型：比如INT UNSIGNED、DATETIME这类，H2的模拟可能有细微差异，比如日期格式是否符合H2的要求（MySQL支持的yyyy-MM-dd HH:mm:ss在H2兼容模式下应该没问题，但保险起见可以统一格式）
• 字符集：如果脚本里指定了CHARSET=utf8mb4，H2在兼容模式下是否支持？可以去掉或者换成H2支持的字符集测试

4. 抓准具体的错误信息，不要只看“外键失败” #

你需要获取更详细的错误日志，比如H2会明确告诉你是哪个外键约束失败，对应的父表是否存在该数据。比如类似这样的错误：

Referential integrity constraint violation: "FK_ORDER_USER: PUBLIC.ORDERS FOREIGN KEY(USER_ID) REFERENCES PUBLIC.USERS(ID) (1001)"; SQL statement:
INSERT INTO orders (id, user_id, amount) VALUES (1, 1001, 99.9) [23506-214]

通过这个信息，你可以直接定位到：是插入user_id=1001的订单时，users表中没有id=1001的记录。这时候要么调整插入顺序，要么检查父表的插入语句是否有问题（比如插入失败了但没报错）。

在JUnit里，你可以捕获RunScript.execute抛出的异常，打印完整的堆栈跟踪，或者配置H2的日志级别为DEBUG，查看执行过程中的细节。

5. 临时禁用外键约束做测试 #

如果上面的步骤都没找到问题，可以临时在脚本开头加一行：

SET REFERENTIAL_INTEGRITY FALSE;

然后在所有插入语句执行完后再加：

SET REFERENTIAL_INTEGRITY TRUE;

如果这样能成功执行，说明问题确实出在约束检查的时机或者插入顺序上，这时候再针对性调整脚本的执行顺序即可。

先从开启兼容模式和查看详细错误日志这两步入手，这几乎是解决这类问题的首选方案，大概率能找到根源。

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