Expo-SQLite在React Native项目中报错求助：openDatabase未定义及main未注册

错误1：TypeError: SQLite.openDatabase is not a function (it is undefined) #

原因分析 #

你使用的expo-sqlite@~14.0.3（对应Expo 51）已废弃同步的openDatabase方法，改用异步的openDatabaseAsync API；同时原代码中SQL语句未用引号包裹，会触发语法错误。

解决步骤 #

1. 替换数据库初始化API：将同步方法改为异步实现，调整database.js代码：

   import * as SQLite from 'expo-sqlite';
   
   // 异步获取数据库实例
   export const getDb = async () => {
     return await SQLite.openDatabaseAsync('myDatabase.db');
   };
   
   export const createTables = async () => {
     const db = await getDb();
     await db.runAsync(`
       CREATE TABLE IF NOT EXISTS users (
         uid INTEGER PRIMARY KEY,
         picture TEXT,
         pversion INTEGER
       )
     `);
   };
   

2. 修正SQL语句格式：必须用反引号或引号包裹SQL字符串，避免被解析为未定义变量。

错误2：Invariant Violation: "main" has not been registered #

原因分析 #

该错误多为第一个数据库模块加载失败引发的连锁问题——模块报错中断了App初始化流程，导致AppRegistry.registerComponent未执行；也可能是Metro服务运行路径错误。

解决步骤 #

1. 优先修复第一个错误：解决数据库API问题后重启项目，此错误大概率自动消失。
2. 重置Metro服务：
   • 停止当前Metro进程（按Ctrl+C）
   • 在项目根目录执行npx expo start -c（-c参数清除缓存）
3. 校验App入口注册：检查App.js或index.js是否正确注册主组件：

   import { AppRegistry } from 'react-native';
   import App from './App';
   import { name as appName } from './app.json';
   
   AppRegistry.registerComponent(appName, () => App);
   

额外注意事项 #

• 所有数据库操作（增删改查）需使用异步方法（runAsync、getAllAsync等），废弃旧的同步transaction回调模式。
• 在App初始化时异步执行表创建逻辑，例如在useEffect中：

  import { useEffect } from 'react';
  import { createTables } from './database';
  
  export default function App() {
    useEffect(() => {
      const initDb = async () => {
        await createTables();
        console.log('数据库表初始化完成');
      };
      initDb();
    }, []);
  
    // 其他组件逻辑
  }
  

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