Spring Boot中H2数据库无感知自动升级方案咨询

核心问题分析 #

你遇到的org.h2.jdbc.JdbcSQLNonTransientConnectionException本质是H2跨大版本（如1.4.x → 2.x）的存储格式不兼容：H2 2.x默认启用了新的PAGE_STORE引擎，无法直接读取1.4.x版本的MV_STORE格式库文件。官方指南的手动迁移对部署者不友好，你的"启动前检测+转储导入"思路完全可行，以下是更贴合Spring Boot生态的替代方案及实现案例。

替代方案 #

方案1：兼容模式临时启动+自动转储迁移 #

利用H2 2.x提供的MODE=LEGACY兼容模式临时连接旧库，导出全量数据后切换到新版引擎创建新库，最后导入数据。这种方案无需额外依赖旧版本H2，但兼容模式仅做迁移用，不能长期运行。

方案2：双版本驱动隔离迁移 #

通过类加载器隔离加载旧版本H2驱动，读取旧库导出SQL；再用新版本驱动创建新库完成导入。这种方案兼容性更强，适合跨大版本的复杂迁移场景。

实现案例（方案2，Spring Boot环境） #

以下代码实现启动时自动检测旧库、导出数据、迁移到新版H2的全流程，无需部署者手动干预：

1. 依赖准备 #

在Maven pom.xml中同时声明新旧版本H2（旧版本设为system scope，避免与新版本类冲突）：

<dependencies>
    <!-- 新版H2，用于应用正常运行 -->
    <dependency>
        <groupId>com.h2database</groupId>
        <artifactId>h2</artifactId>
        <version>2.2.224</version>
        <scope>runtime</scope>
    </dependency>
    <!-- 旧版H2，仅用于迁移，打包时需包含 -->
    <dependency>
        <groupId>com.h2database</groupId>
        <artifactId>h2</artifactId>
        <version>1.4.200</version>
        <scope>system</scope>
        <systemPath>${project.basedir}/lib/h2-1.4.200.jar</systemPath>
    </dependency>
</dependencies>

2. 自动迁移代码 #

创建Spring Boot的CommandLineRunner组件，在应用启动前执行迁移逻辑：

import org.springframework.boot.CommandLineRunner;
import org.springframework.stereotype.Component;

import java.io.*;
import java.sql.*;
import java.net.URL;
import java.net.URLClassLoader;
import java.util.Properties;

@Component
public class H2AutoMigrator implements CommandLineRunner {

    // 旧库文件路径（对应你的原H2配置）
    private static final File OLD_DB_FILE = new File("./data/h2.mv.db");
    // 旧H2 JDBC配置
    private static final String OLD_DB_URL = "jdbc:h2:file:./data/h2;DB_CLOSE_ON_EXIT=FALSE";
    // 新H2 JDBC配置（新版引擎）
    private static final String NEW_DB_URL = "jdbc:h2:file:./data/h2_new;DB_CLOSE_ON_EXIT=FALSE";
    private static final String DB_USER = "sa";
    private static final String DB_PWD = "";
    // 临时SQL导出文件
    private static final String SQL_DUMP_PATH = "./data/h2_migration_dump.sql";

    @Override
    public void run(String... args) throws Exception {
        // 无旧库文件，直接跳过迁移
        if (!OLD_DB_FILE.exists()) {
            return;
        }

        // 1. 用旧版本H2驱动导出旧库数据
        ClassLoader oldH2ClassLoader = new URLClassLoader(
                new URL[]{new File("./lib/h2-1.4.200.jar").toURI().toURL()},
                Thread.currentThread().getContextClassLoader()
        );
        Class<?> oldDriverClass = oldH2ClassLoader.loadClass("org.h2.Driver");
        Driver oldH2Driver = (Driver) oldDriverClass.getDeclaredConstructor().newInstance();

        Properties connProps = new Properties();
        connProps.setProperty("user", DB_USER);
        connProps.setProperty("password", DB_PWD);

        try (Connection oldConn = oldH2Driver.connect(OLD_DB_URL, connProps);
             Statement stmt = oldConn.createStatement()) {
            // 执行H2导出命令
            stmt.execute("SCRIPT TO '" + SQL_DUMP_PATH + "'");
            System.out.println("[H2迁移] 旧库数据导出完成");
        } catch (SQLException e) {
            throw new RuntimeException("[H2迁移] 导出旧库失败", e);
        }

        // 2. 删除旧库文件，避免后续冲突
        if (!OLD_DB_FILE.delete()) {
            throw new RuntimeException("[H2迁移] 无法删除旧库文件，请检查文件权限");
        }

        // 3. 用新版本H2驱动导入数据到新库
        try (Connection newConn = DriverManager.getConnection(NEW_DB_URL, DB_USER, DB_PWD);
             Statement stmt = newConn.createStatement();
             BufferedReader reader = new BufferedReader(new FileReader(SQL_DUMP_PATH))) {

            StringBuilder sqlBuffer = new StringBuilder();
            String line;
            while ((line = reader.readLine()) != null) {
                sqlBuffer.append(line);
                // 执行完整SQL语句（以分号结尾）
                if (line.trim().endsWith(";")) {
                    stmt.execute(sqlBuffer.toString());
                    sqlBuffer.setLength(0);
                }
            }
            System.out.println("[H2迁移] 数据导入新库完成");
        } catch (SQLException e) {
            throw new RuntimeException("[H2迁移] 导入新库失败", e);
        }

        // 4. 重命名新库为原库名，保证应用正常连接
        File newDbFile = new File("./data/h2_new.mv.db");
        if (!newDbFile.renameTo(OLD_DB_FILE)) {
            throw new RuntimeException("[H2迁移] 无法重命名新库文件");
        }

        // 清理临时文件
        new File(SQL_DUMP_PATH).delete();
        System.out.println("[H2迁移] 全流程完成，应用将正常启动");
    }
}

3. 注意事项 #

• 确保应用部署目录下有./lib文件夹，并放入h2-1.4.200.jar
• 生产环境部署前务必测试迁移流程，建议增加自动备份逻辑（比如迁移前复制旧库文件到备份目录）
• 可根据实际的H2库路径、用户名密码调整代码中的配置参数
• 如果是Spring Boot 2.2.x，需确保新版H2与Spring Boot版本兼容（H2 2.x与Spring Boot 2.2.x兼容无问题）

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