Liquibase+H2测试报SQL语法错误但SQL本身无错的问题求助

1. 核对H2数据库配置细节 #

• 检查JDBC URL的兼容模式：如果你的SQL是针对其他数据库（如MySQL、PostgreSQL）编写的，必须在H2的JDBC URL后追加;MODE=目标数据库类型（例如MODE=MySQL），确保和同事的配置完全一致。
• 统一H2版本：不同版本的H2对SQL语法的兼容处理存在差异，确认本地H2版本和同事使用的版本完全相同。

2. 排查Liquibase脚本执行配置 #

• 检查sqlFile标签参数：如果你的Liquibase changelog里用了sqlFile标签的dbms属性，确认该属性值是否匹配H2，错误的数据库类型限制会导致语法解析失败。
• 验证脚本编码：确保脚本的编码格式（如UTF-8无BOM）和同事一致，带BOM的UTF-8文件可能被Liquibase读取为乱码，引发语法错误。

3. 同步IntelliJ IDEA测试环境 #

• 检查JUnit运行配置：对比同事的IDEA JUnit运行配置，确认是否存在特殊的系统属性或环境变量（如liquibase.database.changeLogTableName），保证配置完全一致。
• 清理IDEA缓存：执行File -> Invalidate Caches...清理缓存后重新构建项目，避免旧缓存或编译残留文件干扰执行。

4. 定位具体错误SQL #

• 拆分脚本分步执行：将77张表的脚本拆分为若干段，逐个执行找到触发错误的具体SQL片段，即使整体脚本在其他环境有效，Liquibase的解析逻辑可能对特定细节敏感。
• 开启Liquibase debug日志：在测试运行配置中添加系统属性-Dliquibase.logLevel=debug，通过详细日志定位到报错的具体SQL语句，针对性排查语法兼容问题。

5. 重置本地H2数据库状态 #

• 清理本地H2存储：删除~/.h2/目录下的相关数据库文件，避免之前残留的数据库对象导致冲突。
• 检查连接参数：确认H2连接配置中是否包含DB_CLOSE_ON_EXIT=FALSE等参数，防止数据库状态异常影响脚本执行。

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