Expo SQLite数据库NativeDatabase.prepareAsync调用失败求助

排查与解决步骤： #

• 规范数据库实例管理：Android对资源回收的管控比iOS严格，很可能是代码中意外关闭了数据库实例但后续仍在调用。建议用单例模式确保实例唯一且不被误销毁：

  let dbInstance = null;
  async function getDB() {
    if (!dbInstance) {
      dbInstance = await SQLite.openDatabaseAsync('your-db-name.db');
    }
    return dbInstance;
  }
  

  同时避免在未确认所有异步操作完成的情况下关闭数据库，比如不要在useEffect清理函数中直接调用关闭方法，除非能保证相关请求都已执行完毕。

• 处理异步竞态问题：Android线程调度逻辑和iOS不同，多异步操作可能导致数据库实例状态异常。给所有数据库操作加队列控制，避免并发冲突：

  let dbOperationQueue = Promise.resolve();
  function queueDBTask(task) {
    dbOperationQueue = dbOperationQueue.then(() => task()).catch(err => console.error(err));
    return dbOperationQueue;
  }
  // 使用示例
  queueDBTask(async () => {
    const db = await getDB();
    // 执行具体数据库操作
  });
  

• 升级expo-sqlite版本：部分旧版expo-sqlite在Android端存在资源泄漏或空指针bug，尝试升级到最新稳定版：

  npx expo install expo-sqlite@latest
  

• 检查存储路径与权限：Android 13+对存储权限要求更严格，避免使用自定义存储路径，优先用Expo默认的数据库命名方式，防止因路径访问失败导致实例初始化为null。

• 排查资源泄漏：在代码中添加日志，打印数据库实例的创建、调用、关闭时机，追踪实例何时变为null；也可以用Android Studio Profiler查看内存和数据库连接状态，确认是否存在未释放的连接。

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