Expo项目混合Firebase Web SDK与React Native Firebase的配置排查

核心问题定位 #

你的问题本质是平台环境判断逻辑失效，导致不管是Web还是原生端，都默认加载了Firebase Web SDK，没有根据平台自动切换到React Native Firebase（RNFB）。

关键配置缺失点 #

1. 未实现动态的平台条件导入 #

你需要在Firebase的核心配置文件中，通过平台判断来分别初始化对应的SDK，而不是全局导入单一SDK：

// firebase-config.js
import { Platform } from 'react-native';

let firebaseService;

if (Platform.OS === 'web') {
  // Web端仅初始化Firebase Web SDK支持的服务
  import { initializeApp } from 'firebase/app';
  import { getAnalytics } from 'firebase/analytics';
  
  const webApp = initializeApp(你的Web端Firebase配置);
  firebaseService = {
    app: webApp,
    analytics: getAnalytics(webApp),
    // Web端Dynamic Links需自行实现模拟逻辑（比如解析URL参数）
    dynamicLinks: {
      getInitialLink: async () => {
        const urlParams = new URLSearchParams(window.location.search);
        const link = urlParams.get('link');
        return link ? { url: link } : null;
      }
    }
  };
} else {
  // 原生端初始化React Native Firebase
  import firebase from '@react-native-firebase/app';
  import analytics from '@react-native-firebase/analytics';
  import dynamicLinks from '@react-native-firebase/dynamic-links';
  
  firebase.initializeApp(你的原生端Firebase配置);
  firebaseService = {
    app: firebase.app(),
    analytics: analytics(),
    dynamicLinks: dynamicLinks()
  };
}

export default firebaseService;

2. Shim文件未做平台隔离 #

你添加的Dynamic Links Shim需要确保仅在Web环境下生效，避免覆盖原生端的RNFB实现：

// web-shims/dynamic-links.js
// 仅在Web环境注册Shim
if (typeof window !== 'undefined') {
  globalThis['@react-native-firebase/dynamic-links'] = {
    default: {
      getInitialLink: async () => {
        // 自定义Web端的链接解析逻辑
        const urlParams = new URLSearchParams(window.location.search);
        const link = urlParams.get('link');
        return link ? { url: link } : null;
      },
      // 按需添加其他需要的方法
    }
  };
}

同时在app.json中配置Web端的Shim导入规则：

{
  "expo": {
    "web": {
      "build": {
        "babel": {
          "include": ["web-shims/**/*.js"]
        }
      }
    }
  }
}

3. 全局初始化代码未清理 #

如果你的项目中存在全局的Firebase Web SDK初始化（比如在App.js顶部直接导入并初始化），会导致原生端也强制加载Web SDK，必须把这部分逻辑移到平台判断分支内。

验证步骤 #

1. 原生端运行时，查看控制台是否输出RNFB的初始化日志
2. Web端运行时，确认Analytics调用的是Web SDK接口，Dynamic Links使用自定义的Shim逻辑
3. 测试链接跳转功能，确保原生端触发RNFB的Dynamic Links方法，Web端触发自定义解析逻辑

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