JavaFX中SQLite3插入提交后仍报BUSY错误排查

嘿，我之前踩过好多次SQLite BUSY错误的坑，结合你描述的情况，给你几个实用的排查方向和解决方案：

1. 先检查未释放的数据库资源 #

SQLite的文件级锁很敏感，哪怕有一个未关闭的Connection或PreparedStatement，都可能占着锁导致后续操作报错。尤其是你提到的动态按钮事件处理器，很容易出现“打开连接但忘记关闭”的情况。

建议强制用try-with-resources语法，它会自动帮你关闭资源，不用手动写finally：

// 示例：安全执行数据库写入操作
try (Connection conn = DriverManager.getConnection("jdbc:sqlite:your_database.db");
     PreparedStatement stmt = conn.prepareStatement("INSERT INTO classes(name) VALUES(?)")) {
    stmt.setString(1, "新班级");
    stmt.executeUpdate();
    conn.commit(); // 手动提交（如果关闭了自动提交）
} catch (SQLException e) {
    e.printStackTrace();
    // 出错一定要回滚，避免事务挂起占锁
    if (conn != null) conn.rollback();
}

2. 确认事务边界是否清晰 #

如果你手动关闭了自动提交（conn.setAutoCommit(false)），那必须保证每个事务都有明确的commit或rollback。一旦某个操作抛出异常，事务没回滚，锁就会一直被占用，后续操作直接触发BUSY。

比如在关闭Stage前的commit，要确保之前所有未完成的事务都处理完毕，没有挂起的状态。

3. 排查动态按钮的事件处理器 #

你提到的动态addClass按钮是重点排查对象：

• 是不是每次点击按钮都新建了一个数据库连接，但没关闭？多次点击后就会堆积大量未释放的连接，直接锁死数据库。
• 有没有可能多个按钮的事件同时触发（比如快速连续点击），导致并发写操作冲突？SQLite本身不支持高并发写，这种场景下很容易出BUSY错误。

建议把数据库操作封装成单例DAO类，统一管理连接，避免重复创建：

// 单例DAO示例，统一管理数据库连接
public class ClassDAO {
    private static ClassDAO instance;
    private Connection conn;

    private ClassDAO() {
        try {
            conn = DriverManager.getConnection("jdbc:sqlite:your_database.db");
            conn.setBusyTimeout(5000); // 设置锁等待超时，避免直接抛BUSY
            conn.setAutoCommit(true); // 默认自动提交，按需调整
        } catch (SQLException e) {
            e.printStackTrace();
        }
    }

    public static synchronized ClassDAO getInstance() {
        if (instance == null) {
            instance = new ClassDAO();
        }
        return instance;
    }

    public void addClass(String className) throws SQLException {
        String sql = "INSERT INTO classes(name) VALUES(?)";
        try (PreparedStatement stmt = conn.prepareStatement(sql)) {
            stmt.setString(1, className);
            stmt.executeUpdate();
        }
    }

    // 关闭连接的方法，在Stage关闭时调用
    public void closeConnection() {
        try {
            if (conn != null && !conn.isClosed()) {
                conn.close();
            }
        } catch (SQLException e) {
            e.printStackTrace();
        }
    }
}

然后在动态按钮的事件里调用这个DAO：

addClassButton.setOnAction(e -> {
    try {
        ClassDAO.getInstance().addClass("新创建的班级");
    } catch (SQLException ex) {
        ex.printStackTrace();
        // 这里可以给用户弹出错误提示，比如Alert
    }
});

4. 最后别忘了关闭Stage时的资源释放 #

在Stage的关闭事件里，一定要调用DAO的关闭方法，确保所有数据库资源都被释放：

stage.setOnCloseRequest(e -> {
    ClassDAO.getInstance().closeConnection();
});

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