Android中重新初始化SQLite数据库时抛出异常求助

我之前也踩过这个坑！在Android上重新初始化SQLite数据库时，因为有多个未关闭的SQLite实例持有连接，直接抛出异常卡壳了，折腾了好一阵才找到根源，给你分享下我的解决思路和实操方案：

你碰到的这个异常本质是Android SQLite底层不允许同一个数据库文件被多个未关闭的连接同时操作，尤其是在重新初始化（比如删除旧库重建）的场景下，只要有一个连接没释放，就会触发锁冲突或者直接抛出异常。

我当时是这么处理的，亲测有效：

• 严格控制数据库实例为单例：把你的DatabaseAccessBackend改成单例模式，确保整个App生命周期里只有一个实例在操作数据库。比如用双重检查锁实现线程安全的单例：

private static volatile DatabaseAccessBackend instance;

public static DatabaseAccessBackend getInstance(Context context) {
    if (instance == null) {
        synchronized (DatabaseAccessBackend.class) {
            if (instance == null) {
                // 用Application Context避免内存泄漏
                instance = new DatabaseAccessBackend(context.getApplicationContext());
            }
        }
    }
    return instance;
}

• 重新初始化前强制关闭所有连接：在DatabaseAccessBackend里新增一个同步的关闭方法，确保能彻底释放连接：

public synchronized void closeDatabase() {
    if (mDatabase != null && mDatabase.isOpen()) {
        mDatabase.close();
        mDatabase = null;
    }
}

在执行重新初始化操作前，先调用这个方法，甚至可以检查下App中其他可能持有数据库引用的模块，确保所有连接都被关闭。

• 清理完整的数据库文件：如果是要完全重置数据库，关闭连接后记得删除所有相关的文件——除了主.db文件，还要删掉.db-wal和.db-shm这些WAL模式下的辅助文件，不然残留文件会导致新初始化的数据库出现异常。
• 异步操作后及时释放连接：如果有用到异步线程（比如AsyncTask、Coroutine）操作数据库，一定要在任务结束后主动关闭连接，别让连接在后台线程里挂着占资源。

Android 10及以上版本的存储权限有变化，删除数据库文件时要确保拿到了正确的文件访问权限，不然删不掉旧文件也会导致初始化失败。

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