Android应用数据库恢复时SQLiteReadOnlyDatabaseException崩溃求助

你遇到的SQLITE_READONLY_DBMOVED错误核心原因很明确：当应用还持有活跃的数据库连接时，你替换了底层的.db文件。SQLite会检测到数据库文件被移除/替换，直接将数据库标记为只读状态，后续任何写入操作都会触发这个崩溃。

下面是具体的解决步骤和代码修改建议：

1. 恢复前必须完全关闭所有数据库连接 #

这是最关键的一步，你必须确保在替换.db文件前，应用中所有的SQLiteDatabase、SQLiteOpenHelper（或Room数据库实例）都被彻底关闭。如果有任何活跃连接存在，SQLite会锁定文件，导致替换操作后数据库状态异常。

比如，如果你用的是原生SQLiteOpenHelper，可以添加一个关闭连接的方法：

// 假设你有全局的SQLiteOpenHelper实例
private SQLiteOpenHelper dbHelper;

private void closeAllDatabaseConnections() {
    if (dbHelper != null) {
        // 关闭Helper持有的所有数据库连接
        dbHelper.close();
        // 置空实例，避免后续误复用
        dbHelper = null;
    }
}

如果用的是Room，需要关闭RoomDatabase实例：

private AppDatabase roomDb;

private void closeRoomDatabase() {
    if (roomDb != null && roomDb.isOpen()) {
        roomDb.close();
        roomDb = null;
    }
}

2. 修改文件移动逻辑，确保权限和原子性 #

直接移动文件到/data/data/<packagename>/databases/目录可能会导致文件权限不正确（外部存储的文件权限和应用私有目录的权限不一致），这也会引发SQLite读写问题。建议改用复制+权限设置的方式，同时确保旧文件删除彻底：

修改后的moveContents()方法：

public void moveContents(){
    // 第一步：先关闭所有数据库连接
    closeAllDatabaseConnections();

    File destinationFolder = new File(DATABASE_FOLDER_PATH);
    File sourceFolder = new File(Environment.getExternalStorageDirectory() + "/AppName/Backups/_extracts");
    
    if (!destinationFolder.exists()) {
        if (!destinationFolder.mkdirs()) {
            Log.e("FLERROR", "Failed to create destination folder: " + destinationFolder.getAbsolutePath());
            return;
        }
    }

    if (sourceFolder.exists() && sourceFolder.isDirectory()) {
        File[] listOfFiles = sourceFolder.listFiles();
        if (listOfFiles != null) {
            for (File child : listOfFiles ) {
                try {
                    File destFile = new File(destinationFolder, child.getName());
                    
                    // 删除旧文件（确保连接已关闭，否则删除可能失败）
                    if(destFile.exists()){
                        if (!destFile.delete()) {
                            Log.e("FLERROR", "Failed to delete old database file: " + destFile.getAbsolutePath());
                            continue;
                        }
                    }

                    // 复制文件到目标目录（比移动更可靠，避免权限问题）
                    FileUtils.copyFileToDirectory(child, destinationFolder, false);
                    
                    // 设置正确的文件权限，确保SQLite能读写
                    destFile.setReadable(true, false); // 所有用户可读
                    destFile.setWritable(true, false); // 所有用户可写
                    destFile.setExecutable(false, false); // 不需要执行权限

                } catch (IOException e) {
                    Log.e("FLERROR","Error handling database file",e);
                }
            }
            // 删除解压后的源文件夹
            sourceFolder.delete();
        }
    } else {
        Log.e("FLERROR", sourceFolder + " Folder does not exist");
    }
}

3. 恢复完成后的注意事项 #

• 恢复操作完成后，不要复用之前的SQLiteOpenHelper或Room实例，需要重新初始化数据库连接（比如重新创建SQLiteOpenHelper实例，或重新获取Room数据库实例）。
• 建议备份时包含相关日志文件：虽然你现在没备份-journal，但SQLite的Write-Ahead Logging（WAL）模式下，-wal和-shm文件也会存在。备份前可以先调用SQLiteDatabase.disableWriteAheadLogging()，让SQLite将WAL日志合并到主.db文件，再进行备份，这样能避免数据库状态不一致。

内容的提问来源于stack exchange，提问作者mavilla vishnu vardhan