React Native升级Firebase v9后报错客户端离线无法获取文档如何解决

你遇到的报错核心原因是仅导入了Firebase核心的compat兼容包，没有额外引入Firestore服务对应的compat版本，导致Firestore实例未完成正确初始化，并非真实的客户端网络离线。

方案1：兼容模式（原有v8业务代码无需修改） #

仅调整fire-config.js的导入逻辑即可：

// 注释原有导入
//import firebase from 'firebase';
// 导入compat核心包
import firebase from 'firebase/compat/app';
// 额外导入你用到的所有服务的compat版本，此处为firestore和functions
import 'firebase/compat/firestore';
import 'firebase/compat/functions';

// 原有配置、初始化代码完全不变
const firebaseConfig = {
    apiKey: "XXXXX",
    authDomain: "XXXXX",
    databaseURL: "XXXX",
    projectId: "XXXX",
    storageBucket: "XXXX",
    messagingSenderId: "XXXXX",
    appId: "XXXX",
    measurementId: "XXXXX"
  };
try {
  firebase.initializeApp(firebaseConfig);
} catch(err){
  if (!/already exists/.test(err.message)) {
    console.error('Firebase initialization error', err.stack)}
}
const fire = firebase;
export {fire};

修改后userController.js的代码不需要做任何调整，原有v8写法可以直接运行。

方案2：升级为v9原生模块化写法（体积更优，推荐长期使用） #

第一步：修改fire-config.js #

import { initializeApp } from 'firebase/app';
import { getFirestore } from 'firebase/firestore';
import { getFunctions } from 'firebase/functions';

const firebaseConfig = {
    apiKey: "XXXXX",
    authDomain: "XXXXX",
    databaseURL: "XXXX",
    projectId: "XXXX",
    storageBucket: "XXXX",
    messagingSenderId: "XXXXX",
    appId: "XXXX",
    measurementId: "XXXXX"
};

const app = initializeApp(firebaseConfig);
// 导出服务实例
export const db = getFirestore(app);
export const functions = getFunctions(app);

第二步：修改userController.js的调用逻辑 #

import { db } from "../config/fire-config";
import { doc, getDoc } from "firebase/firestore";

const getUserDetail = async (user) => {
  let userDetail = {};
  const docRef = doc(db, "users", user.uid);
  const docSnap = await getDoc(docRef);

  if (docSnap.exists()) {
    userDetail = {
      id: docSnap.id,
      ...docSnap.data(),
    };
  }
  return userDetail;
};

异常排查 #

如果修改后仍报错，依次执行以下操作：

• 清理React Native缓存重新打包：执行命令npx react-native start --reset-cache后重新运行项目
• 确认运行设备/模拟器网络正常，没有代理拦截Firebase请求
• 确认Firebase控制台中Firestore的安全规则未限制当前用户的访问权限

内容的提问来源于stack exchange，提问作者S.B.