React Native（Android）应用更新后如何清除旧Sqlite3数据库数据？

可能的原因 #

• 数据库文件未被正确覆盖：Android应用更新时，原存储路径（/data/data/[包名]/databases/）下的旧数据库未被新版本替换，比如旧文件权限为只读，或更新逻辑仅在首次安装时复制数据库，更新阶段跳过了替换步骤。
• 旧数据库连接未释放：应用启动后复用了更新前建立的数据库连接，导致始终读取旧文件的缓存数据，未加载新数据库。
• 未提交的事务/缓存快照：旧的数据库事务未完成或提交，新数据写入后未持久化，读取时仍调用旧的数据快照；若存在自定义内存缓存，更新后未同步清空缓存。
• 资源文件复制逻辑缺陷：如果数据库是从assets目录复制到内部存储的，更新时复制逻辑只执行首次安装流程，跳过了覆盖旧文件的步骤。

对应修复措施 #

1. 强制替换旧数据库文件 #

确保更新时，新版本的预打包数据库覆盖旧文件，示例代码：

import RNFS from 'react-native-fs';
import { Platform } from 'react-native';

const copyDatabase = async () => {
  const targetDbPath = Platform.OS === 'android' 
    ? `${RNFS.DocumentDirectoryPath}/your-db-name.db` 
    : `${RNFS.MainBundlePath}/your-db-name.db`;
  const assetDbPath = Platform.OS === 'android' 
    ? 'database/your-db-name.db' 
    : 'your-db-name.db';

  // 更新时先删除旧数据库，再复制新文件
  if (await RNFS.exists(targetDbPath)) {
    await RNFS.unlink(targetDbPath);
  }
  await RNFS.copyFileAssets(assetDbPath, targetDbPath);
};

// 应用启动或更新后首次启动时调用
copyDatabase();

注意：Android 10+需确保应用拥有内部存储读写权限。

2. 重启数据库连接 #

更新后关闭旧连接，重新建立新连接，避免复用旧会话：

import SQLite from 'react-native-sqlite-storage';

let dbInstance = null;

const initDatabase = async () => {
  // 先关闭旧连接
  if (dbInstance) {
    await dbInstance.close();
  }
  // 重新初始化数据库连接
  dbInstance = await SQLite.openDatabase({
    name: 'your-db-name.db',
    location: 'default'
  });
};

// 应用启动、版本更新后调用
initDatabase();

3. 清理事务与缓存 #

• 确保所有写操作正确提交事务，避免未完成事务导致数据快照未更新：

dbInstance.transaction((tx) => {
  tx.executeSql(
    'UPDATE your_table SET column = ? WHERE id = ?',
    ['new-value', 1],
    (_, result) => {},
    (_, error) => {
      console.error('更新失败:', error);
      return false; // 回滚异常事务
    }
  );
});

• 若存在内存缓存，更新数据库后立即清空缓存：

// 示例内存缓存对象
let dataCache = {};

const clearAppCache = () => {
  dataCache = {};
};

// 数据库更新完成后调用
clearAppCache();

4. 基于版本号触发升级逻辑 #

给数据库添加版本标识，启动时检查版本差异，自动执行替换或迁移：

const CURRENT_DB_VERSION = 2; // 新版本号

const initDatabase = async () => {
  await SQLite.openDatabase({
    name: 'your-db-name.db',
    location: 'default',
    version: CURRENT_DB_VERSION,
    onCreate: (tx) => { /* 首次创建数据库表结构逻辑 */ },
    onUpgrade: (tx, oldVersion, newVersion) => {
      // 版本低于当前时，执行数据库替换或数据迁移
      if (oldVersion < newVersion) {
        // 这里可调用数据库替换逻辑，或执行表结构更新脚本
      }
    }
  });
};

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