Firebase SDK 8.2.3开启Firestore离线持久化报FirebaseError如何解决

你遇到的报错核心是Firebase 8.x版本的导入规则问题：即使安装了完整的firebase依赖包，默认的全量导入仅会加载内存版Firestore，不会自动引入带持久化支持的完整Firestore构建包。

• 第一步：修改Firebase相关导入语句，显式引入Firestore完整构建模块，替换你原有App.js的导入部分：

//imports related to firebase
import * as firebase from "firebase";
import 'firebase/firestore'; // 新增这行，显式引入带持久化支持的Firestore构建
import ApiKeys from "./constants/ApiKeys";

• 第二步：调整初始化逻辑的作用域问题，避免db变量作用域异常导致重复初始化，修改后的初始化代码如下：

export default function App() {
  //firebase project initialisation
  let db;
  if (!firebase.apps.length) {
    firebase.initializeApp(ApiKeys);
    db = firebase.firestore();
    db.settings({ experimentalForceLongPolling: true });
    console.log("DB INITIALISED");
    db.enablePersistence()
        .catch((err) => {
            if (err.code == 'failed-precondition') {
                // 多标签页打开时无法开启持久化，同一时间仅支持一个标签页开启该功能
            } else if (err.code == 'unimplemented') {
                // 当前运行环境不支持持久化所需的特性
            }
      })
  } else {
    db = firebase.firestore();
  }
  // 剩余业务逻辑
  // ...
}

• 第三步：如果修改后仍报错，执行以下排查操作：
  • 检查项目中是否存在其他地方导入了@firebase/firestore/memory内存版Firestore模块，删除对应导入语句
  • 删除本地node_modules文件夹、package-lock.json或yarn.lock文件后重新执行npm install或yarn install安装依赖
  • 可将Firebase SDK升级到8.x分支的最新稳定版（如8.10.0），你当前使用的8.2.3属于较早的小版本，存在已知的Firestore导入Bug

内容的提问来源于stack exchange，提问作者Kubaguette The Testobun