React Native Firebase 在 Expo 项目中集成 Firestore 的注意事项

在使用 React Native Firebase 库时，许多开发者选择在 Expo 项目中集成 Firestore 数据库功能。然而，在实际开发过程中，可能会遇到一些特殊问题需要特别注意。

常见问题现象

开发者在 Expo 项目中集成 Firestore 后，尝试执行基本的文档添加操作时，可能会遇到类似以下的错误信息：

undefined this._firestore.native.documentSet is not a function (it is undefined)

这个错误通常出现在调用 Firestore 的 add() 方法时，表明原生模块未能正确加载或初始化。

问题根源分析

经过深入排查，发现这个问题与 Expo 项目的构建方式密切相关。在 Expo 开发环境中，存在两种主要的运行方式：

1. 通过 npx expo start 命令启动开发服务器，然后按 a 或 i 键启动 Android 或 iOS 模拟器
2. 直接通过 npx expo run:android 或 npx expo run:ios 命令构建并运行项目

问题就出在第一种方式上。当使用 expo start 并通过快捷键启动模拟器时，Expo 并不会执行完整的原生模块构建过程，导致 React Native Firebase 的原生部分未能正确集成到应用中。

解决方案

要确保 Firestore 模块正常工作，必须采用完整的构建流程：

1. 对于 Android 开发：

npx expo run:android

2. 对于 iOS 开发：

npx expo run:ios

这种方式会执行完整的原生模块构建过程，确保所有必要的原生代码都被正确编译和集成到应用中。

最佳实践建议

1. 开发环境配置：在集成 React Native Firebase 时，建议始终使用完整的构建命令（run:android/run:ios）而非快捷方式

2. 模块初始化检查：在应用启动时，可以添加简单的检查逻辑确认 Firestore 模块是否已正确初始化

3. 错误处理：对 Firestore 操作添加完善的错误处理，便于快速定位问题

4. 构建缓存清理：在遇到类似问题时，尝试清理构建缓存并重新构建：

npx expo prebuild --clean

总结

Expo 为 React Native 开发提供了便利，但在集成需要原生模块的库时，开发者需要注意构建方式的差异。React Native Firebase 的 Firestore 模块需要完整的原生构建过程才能正常工作，简单的开发服务器启动方式可能无法满足这一需求。遵循正确的构建流程，可以避免许多潜在的问题，确保数据库功能正常运作。