Lealone数据库启动时执行SQL脚本报错问题分析与解决

在使用Lealone数据库6.1.0-SNAPSHOT版本时，开发者在尝试通过Java代码创建数据库并执行初始化脚本时遇到了一个异常问题。本文将详细分析该问题的背景、原因以及解决方案。

问题背景

在Lealone数据库应用开发中，开发者通常需要在应用启动时自动创建数据库并执行初始化SQL脚本。一个典型的场景是：当Spring Boot应用启动时，先初始化Lealone数据库，创建必要的表结构，然后再启动应用服务。

问题现象

开发者编写了一个工具类LealoneSqlUtil，主要功能包括：

1. 创建数据库
2. 执行建表SQL
3. 执行初始化数据SQL

当首次启动应用时，一切正常。但在重启应用时，执行到建表SQL时会抛出以下异常：

IndexOutOfBoundsException: Index -1 out of bounds for length 2

异常发生在执行CREATE TABLE语句时，具体是在尝试创建Task表的时候。

问题分析

经过深入分析，我们发现以下几个关键点：

1. 首次启动与重启的差异：首次启动时数据库文件不存在，重启时数据库文件已存在
2. SQL执行顺序：问题发生在执行建表SQL阶段，而非创建数据库阶段
3. 异常类型：IndexOutOfBoundsException表明可能是内部数据结构处理异常

解决方案

Lealone项目维护者提供了两种更简洁的解决方案：

方案一：使用Lealone.runScript方法

public static void main(String[] args) {
    Lealone.main(args, () -> {
        Lealone.runScript("jdbc:lealone:embed:lealone", "src/test/resources/mytable.sql");
    });
}

方案二：分步执行创建数据库和建表脚本

public static void main(String[] args) {
    Lealone.main(args, () -> {
        String sql = "create database if not exists mydb parameters(database_to_upper=false)";
        Lealone.executeSql("jdbc:lealone:embed:lealone", sql);
        Lealone.runScript("jdbc:lealone:embed:mydb", "src/test/resources/mytable.sql");
    });
}

最佳实践建议

1. 使用最新API：Lealone提供了更简洁的API(Lealone.executeSql和Lealone.runScript)来执行SQL和脚本，应优先使用这些方法
2. 脚本管理：将建表SQL和维护SQL分开存放，便于管理和执行
3. 异常处理：对于可能重复执行的SQL语句(如CREATE TABLE IF NOT EXISTS)，应做好异常捕获和处理
4. 连接管理：确保每个SQL执行后正确关闭连接，避免资源泄漏

总结

Lealone数据库提供了灵活的方式来初始化和维护数据库结构。通过使用官方推荐的方法，可以避免直接使用JDBC时可能遇到的一些底层问题。对于需要在应用启动时初始化数据库的场景，建议采用Lealone提供的高级API，这样代码更简洁，也更不容易出错。

对于需要更复杂初始化逻辑的场景，可以考虑将这些逻辑封装在数据库存储过程中，然后在应用启动时调用这些存储过程，这样可以将数据库相关的逻辑集中在数据库端，使应用代码更加清晰。