React Native Firebase 在 RN 0.74 版本中的兼容性问题分析与解决方案

问题背景

React Native Firebase 是一个流行的 React Native 插件，用于在移动应用中集成 Firebase 服务。随着 React Native 0.74 版本的发布，许多开发者在升级后发现 Firebase 初始化失败，出现"未创建默认 Firebase 应用"的错误提示。

核心问题分析

这个问题主要源于 React Native 0.74 版本对原生模块处理方式的改变，特别是在新架构（New Architecture）下。当启用新架构时，原生模块的访问方式发生了变化，导致 React Native Firebase 无法正确获取原生模块的方法和属性。

技术细节

在传统架构下，原生模块通过直接访问模块对象的属性来工作。但在新架构下，模块的方法实际上是定义在模块的原型链上。React Native Firebase 原有的代码仅通过 Object.keys(NativeModule) 获取属性，这在新架构下会返回空数组，因为方法都位于原型链上。

解决方案

经过社区讨论和测试，确定以下补丁可以有效解决这个问题：

function nativeModuleWrapped(namespace, NativeModule, argToPrepend) {
  const native = NativeModule;
  if (!NativeModule) {
    return NativeModule;
  }

  let properties = Object.keys(Object.getPrototypeOf(NativeModule));
  if (!properties.length) properties = Object.keys(NativeModule);

  for (let i = 0, len = properties.length; i < len; i++) {
    const property = properties[i];
    if (typeof NativeModule[property] === 'function') {
      native[property] = nativeModuleMethodWrapped(namespace, NativeModule[property], argToPrepend);
    } else {
      native[property] = NativeModule[property];
    }
  }

  return native;
}

这个修改实现了：

1. 首先尝试从原型链获取方法列表
2. 如果原型链上没有方法，则回退到传统方式
3. 兼容新旧两种架构模式

不同环境下的表现

Android 平台

• 新架构下需要应用上述补丁
• 传统架构下工作正常
• 补丁已合并到 React Native Firebase v20 版本

iOS 平台

• 问题更为复杂，特别是启用无桥接(Bridgeless)模式时
• 部分开发者报告需要额外配置 Podfile
• 建议暂时禁用无桥接模式等待官方完整支持

最佳实践建议

1. 版本选择：

   • 使用 React Native Firebase v20 或更高版本
   • 确保配套的 Firebase SDK 版本兼容

2. 初始化检查：

   import firebase from '@react-native-firebase/app';
   
   try {
     if (!firebase.apps.length) {
       await firebase.initializeApp();
     }
   } catch (error) {
     console.error('Firebase initialization error', error);
   }
   

3. Expo 用户注意事项：

   • 确保正确配置 app.json 中的插件设置
   • 检查是否遗漏了必要的原生配置

4. 调试技巧：

   • 在原生模块包装函数中添加日志，验证方法是否被正确获取
   • 检查热重载是否影响 Firebase 监听器（如 auth 状态变化）

未来展望

React Native 新架构是未来的方向，React Native Firebase 团队正在积极适配。开发者可以：

• 关注官方更新日志
• 在非生产环境中测试新架构兼容性
• 参与社区讨论报告发现的问题

通过理解这些技术细节和解决方案，开发者可以更顺利地完成 React Native 版本升级，同时保持 Firebase 功能的稳定性。