React Native中TypeORM初始化报错：Cannot read property 'type' of undefined

核心原因分析 #

第一个错误TypeError: Cannot read property 'type' of undefined是触发后续AppRegistry错误的根源，本质是TypeORM在React Native环境下无法正确加载SQLite驱动，或配置项存在问题。

具体修复步骤 #

1. 替换SQLite依赖包 #

sqlite3是Node.js环境专用包，React Native不支持，必须替换为RN适配的SQLite库：

# 卸载原有依赖
npm uninstall sqlite3
# 安装RN专用SQLite库
npm install react-native-sqlite-storage

2. 修改DataSource配置，指定RN专用驱动 #

TypeORM在RN环境下需要显式指定SQLite驱动，同时调整实体导入方式避免潜在问题：

import { DataSource } from "typeorm";
import { Task } from "./your/path/to/Task"; // 直接导入实体类

export const AppDataSource = new DataSource({
  type: "sqlite",
  database: "test.db", // 建议添加.db后缀，避免路径识别异常
  synchronize: false,
  logging: true,
  entities: [Task], // 直接传入实体类数组，替代models变量排查导出问题
  driver: require("react-native-sqlite-storage"), // 显式指定RN的SQLite驱动
});

3. 检查实体定义的潜在问题 #

• 确保TaskStatus和TaskObject是已正确定义的类型/接口，避免JSON转换时出错
• 确认实体装饰器已正确导入：import { Entity, PrimaryColumn, Column } from "typeorm";

4. 调整DataSource初始化时机 #

不要在App入口同步初始化，改为组件挂载后异步执行，避免阻塞RN启动流程：

// 根组件（如App.tsx）中
import { useEffect } from "react";
import { AppDataSource } from "./your/path/to/DataSource";

function App() {
  useEffect(() => {
    const initDB = async () => {
      try {
        await AppDataSource.initialize();
        console.log("数据库连接成功");
      } catch (error) {
        console.error("数据库初始化失败:", error);
      }
    };
    initDB();
  }, []);

  // ... 其他组件逻辑
}

export default App;

5. 清理缓存并重建项目 #

# 重置RN缓存
npx react-native start --reset-cache
# 重新编译Android项目
cd android && ./gradlew clean && cd .. && npx react-native run-android

额外排查点 #

• 检查models变量是否正确导出所有实体类，排查是否存在undefined项
• 确认TypeORM版本与react-native-sqlite-storage兼容（推荐使用TypeORM 0.3.x版本）

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