react-native-sqlite-storage打开数据库报错：Cannot convert null value to object

你遇到的报错核心原因是SQLite.openDatabase调用后返回了null，后续代码尝试将null转为对象时触发错误。以下是几个必查的解决方向：

1. 调整数据库初始化时机 #

不要在组件外部直接调用openDatabase，React Native启动初期，原生模块可能还未完成加载，导致SQLite对象内部依赖未就绪，返回null。建议把初始化逻辑放到组件内部的useEffect中，确保在原生环境准备完成后执行：

import { useContext, useEffect, useState } from 'react';
import SQLite from 'react-native-sqlite-storage';
import { WorkoutDataContext, WorkoutDataSetterContext } from '../App';

let db;

export const saveWorkout = () => {
  if (!db) {
    throw new Error('数据库尚未初始化，请先完成初始化操作');
  }
  // 这里写你的数据库操作逻辑
};

// 新建一个初始化组件，在App中引入
export const DatabaseInitializer = () => {
  useEffect(() => {
    // 启用Promise模式，更适配React的异步逻辑
    SQLite.enablePromise(true);
    
    const initDB = async () => {
      try {
        db = await SQLite.openDatabase({
          name: "test.db",
          location: 'default' // 必须添加，部分平台依赖该参数
        });
        console.log('数据库打开成功');
      } catch (err) {
        console.error('数据库打开失败:', err);
      }
    };

    initDB();
  }, []);

  return null; // 无需渲染UI
};

之后在你的App组件中引入DatabaseInitializer，确保它在应用启动时就被加载执行。

2. 补充必要的配置参数 #

部分平台（比如Android）要求必须指定数据库存储位置，在openDatabase的配置对象中添加location: 'default'，否则会导致初始化失败返回null。

3. 验证原生端配置是否正确 #

即便执行了npm install，自动配置可能存在遗漏，手动检查以下内容：

• Android：
  • 打开android/app/src/main/java/[你的包名]/MainApplication.java，确认已添加SQLite插件包：

    import org.pgsqlite.SQLitePluginPackage;
    
    @Override
    protected List<ReactPackage> getPackages() {
      List<ReactPackage> packages = new PackageList(this).getPackages();
      packages.add(new SQLitePluginPackage()); // 确保这行存在
      return packages;
    }
    

  • 检查android/settings.gradle是否包含：

    include ':react-native-sqlite-storage'
    project(':react-native-sqlite-storage').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-sqlite-storage/src/android')
    

• iOS：
  • 打开ios/Podfile，确认包含：

    pod 'react-native-sqlite-storage', :path => '../node_modules/react-native-sqlite-storage'
    

  • 执行cd ios && pod install，重新安装依赖。

4. 改用Promise模式处理初始化 #

默认的回调模式容易隐藏初始化错误，启用Promise模式后，用async/await调用openDatabase，能更清晰地捕获初始化过程中的异常，便于排查问题。

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