React Native Expo环境下SQLite使用及依赖选择与报错求助

1. react-native-sqlite-storage 兼容 Expo 吗？ #

react-native-sqlite-storage不兼容Expo托管工作流（Managed Workflow）——也就是纯Expo创建的项目。因为它属于原生模块，需要修改iOS/Android的原生代码完成链接，但Expo托管环境不允许直接操作原生层。如果你的项目是Expo裸工作流（Bare Workflow，已执行eject或prebuild），可以手动配置原生部分来使用，但步骤繁琐，还容易出问题。

2. 必须用 expo-sqlite 吗？ #

不是硬性要求，但非常推荐在Expo项目里用expo-sqlite：

• 它是Expo官方维护的SQLite库，完美适配Expo的所有工作流，不需要额外做原生配置，开箱即用。
• API支持Promise风格，比react-native-sqlite-storage的回调写法更顺手，也兼容传统回调。
• 对于重度依赖数据库的App，expo-sqlite的稳定性和社区支持更靠谱，后续遇到问题也更容易找到解决方案。

要是你非得用react-native-sqlite-storage，只能在裸工作流里折腾原生配置，但会失去Expo的OTA更新等便利，还容易碰到你现在遇到的这类加载报错。

3. 你遇到的两个报错怎么解决？ #

报错1：TypeError: Cannot convert null value to object #

这个错误本质是react-native-sqlite-storage的原生模块没正确链接，JS层调用时拿到了null对象，导致类型转换失败。

• 如果是托管工作流，直接换expo-sqlite就行，这个问题在托管环境里没法解决。
• 如果是裸工作流，重新检查原生配置：iOS确认pod里添加了SQLite依赖，Android检查gradle配置；然后清理Metro缓存npx react-native start --reset-cache，再重新构建原生项目（iOS跑pod install，Android先./gradlew clean再编译）。

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

这个错误的核心是模块加载失败打断了App初始化，导致AppRegistry没注册根组件，而react-native-sqlite-storage加载失败就是导火索。

• 托管工作流下直接替换成expo-sqlite，原生模块加载问题解决后，App初始化就能正常完成。
• 裸工作流下，先注释掉所有数据库相关代码，确认App能正常启动，再逐步加回数据库代码排查问题——比如检查库的版本是否和RN版本兼容，导入路径有没有写错，初始化代码有没有语法错误。

4. 重度依赖数据库的Expo项目建议 #

• 优先用expo-sqlite，它支持完整的SQLite功能：事务、索引、复杂查询全都有，完全能满足重度数据库需求。
• 如果需要ORM（对象关系映射）来简化代码，可以搭配typeorm（需适配Expo环境），或者用专门为React Native/Expo优化的watermelon-db，能提升数据操作的效率和可读性。

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