Spring Batch升级H2数据库1.4.200至2.1.214后表找不到问题

升级H2到2.1.214后出现表找不到的错误，核心原因是H2 2.x版本与Spring Boot 2.1.11.RELEASE不兼容，具体细节和解决思路如下：

原因分析 #

• 版本兼容性不匹配：Spring Boot 2.1.x系列默认依赖的H2版本是1.4.200，H2 2.x做了大量语法规则、默认行为的变更（比如更严格的SQL语法检查、模式默认值调整），旧版本Spring Boot的自动配置逻辑没有适配这些变化，导致Spring Batch的自动建表脚本执行失败，系统表未被创建。
• DDL执行失败：Spring Batch依赖自动执行内置的H2建表脚本初始化系统表，但H2 2.x对SQL的兼容性要求更严格，旧脚本中的语法可能在新版本H2中无法正常执行，最终导致BATCH_JOB_INSTANCE等表缺失。

解决办法 #

1. 降级H2到兼容版本 #

如果不需要强制使用H2 2.x，直接将H2版本回退到Spring Boot 2.1.11默认的1.4.200，这是最稳妥的方案，能避免兼容性问题。

2. 修改H2连接参数（强制用2.x时） #

在JDBC URL中添加兼容模式参数，让H2模拟旧版本的行为，确保建表脚本能正常执行。修改后的数据源配置如下：

spring:
    application:
        name: myBatch
    cache:
        type: simple
    datasource:
        type: com.zaxxer.hikari.HikariDataSource
        url: jdbc:h2:mem:myBatch;DB_CLOSE_DELAY=-1;DB_CLOSE_ON_EXIT=FALSE;MODE=LEGACY;DATABASE_TO_UPPER=false
        name:
        username:
        password:
        hikari:
            auto-commit: false

• MODE=LEGACY：启用旧版本兼容模式，放宽语法检查
• DATABASE_TO_UPPER=false：关闭自动将标识符转为大写的行为，避免表名匹配问题

3. 手动执行建表脚本 #

如果上述参数调整无效，可以手动执行Spring Batch的H2建表脚本。脚本可以从Spring Batch的依赖包中获取（路径通常为org/springframework/batch/core/schema-h2.sql），或者从官方源码仓库下载对应版本的脚本，在应用启动前执行。

4. 升级Spring Boot版本 #

考虑将Spring Boot升级到2.7.x及以上版本，这些版本已经官方适配了H2 2.x的变化，能更好地兼容新版本H2，同时也能获得更多安全更新和功能改进。

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