Android App SQLite资产数据库更新时如何保留用户数据？

核心流程 #

更新应用时，不要直接覆盖现有数据库，而是先导出用户可读写表的数据，再将新的资产数据库复制到目标位置，最后把导出的数据导入到新库的对应表中（需兼容新的Schema）。

具体实现步骤 #

1. 导出用户数据 #

在应用启动检测到数据库版本更新时，先连接旧数据库，读取所有可读写表的用户数据，保存到临时存储（比如内存对象、本地JSON/CSV文件）。

• 只导出用户生成的数据，忽略只读表内容（新资产库会自带最新的只读数据）。
• 示例代码逻辑：

// 获取旧数据库路径
String oldDbPath = getDatabasePath("your_db_name.db").getAbsolutePath();
SQLiteDatabase oldDb = SQLiteDatabase.openDatabase(oldDbPath, null, SQLiteDatabase.OPEN_READONLY);

// 导出可读写表（以user_data表为例）
Cursor cursor = oldDb.query("user_data", null, null, null, null, null, null);
List<ContentValues> userDataList = new ArrayList<>();
while (cursor.moveToNext()) {
    ContentValues values = new ContentValues();
    // 遍历列存入ContentValues
    for (int i = 0; i < cursor.getColumnCount(); i++) {
        String columnName = cursor.getColumnName(i);
        switch (cursor.getType(i)) {
            case Cursor.FIELD_TYPE_INTEGER:
                values.put(columnName, cursor.getInt(i));
                break;
            case Cursor.FIELD_TYPE_STRING:
                values.put(columnName, cursor.getString(i));
                break;
            case Cursor.FIELD_TYPE_FLOAT:
                values.put(columnName, cursor.getFloat(i));
                break;
            case Cursor.FIELD_TYPE_BLOB:
                values.put(columnName, cursor.getBlob(i));
                break;
            default:
                values.put(columnName, cursor.getString(i));
        }
    }
    userDataList.add(values);
}
cursor.close();
oldDb.close();

2. 替换为新的资产数据库 #

删除旧数据库文件，将assets目录下的新db文件复制到应用的数据库目录。

• 示例代码逻辑：

// 删除旧数据库
File oldDbFile = new File(oldDbPath);
if (oldDbFile.exists()) {
    oldDbFile.delete();
}

// 复制新资产数据库到目标路径
InputStream is = getAssets().open("new_db_version.db");
OutputStream os = new FileOutputStream(oldDbPath);
byte[] buffer = new byte[1024];
int length;
while ((length = is.read(buffer)) > 0) {
    os.write(buffer, 0, length);
}
os.flush();
os.close();
is.close();

3. 导入用户数据到新数据库 #

连接新数据库，将导出的用户数据插入对应可读写表，同时处理Schema变化（比如新增字段的默认值）。

• 注意：若新表新增字段，需设置合理默认值避免插入失败；若字段类型变更，要做数据转换。
• 示例代码逻辑：

SQLiteDatabase newDb = SQLiteDatabase.openDatabase(oldDbPath, null, SQLiteDatabase.OPEN_READWRITE);
newDb.beginTransaction();
try {
    for (ContentValues values : userDataList) {
        // 处理新增字段：比如新表新增create_time字段，设置默认值
        if (!values.containsKey("create_time")) {
            values.put("create_time", System.currentTimeMillis());
        }
        newDb.insert("user_data", null, values);
    }
    newDb.setTransactionSuccessful();
} catch (Exception e) {
    // 处理插入异常，比如数据格式不兼容
    e.printStackTrace();
} finally {
    newDb.endTransaction();
    newDb.close();
}

4. 版本控制与更新检测 #

在应用中维护数据库版本号（比如存在SharedPreferences中），每次启动时对比新资产库的版本号（可在新db的配置表中存储版本号），版本不一致时触发导出-替换-导入流程。

注意事项 #

• 备份机制：导出数据后可备份到外部存储（如SD卡），避免替换过程中异常导致数据丢失。
• 大数据量处理：若用户数据量较大，分批次导出/导入，避免内存溢出。
• 数据兼容性：新表删除旧字段时，导入要跳过对应字段；字段类型变更需做转换处理。

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