Firebase/firestore/lite无法与Firebase模拟器兼容？求解决方案

Firestore Lite SDK可以配合Firebase模拟器使用，你遇到的报错是特定版本SDK在Node.js环境下的兼容性问题，以下是具体分析和解决方案：

问题原因 #

在Firebase JS SDK 9.15.0版本中，Firestore Lite的HTTP请求处理逻辑在Node.js环境下，对模拟器的HTTP（非HTTPS）请求支持不完善，导致请求无响应或抛出"Request failed with error: undefined"错误。而完整版Firestore SDK使用gRPC连接，不存在此问题；连接真实Firestore时，Lite SDK使用HTTPS请求，也能正常工作。

解决方案 #

方案1：升级Firebase SDK到9.17.0及以上版本 #

Firebase团队在9.17.0版本中修复了Lite SDK与模拟器的兼容性问题，升级后直接使用现有代码即可正常连接模拟器。

执行升级命令：

npm install firebase@^9.17.0

方案2：为Lite SDK配置自定义Fetch（针对9.15.0版本） #

如果暂时无法升级SDK，可以在Node.js环境中为Lite SDK指定自定义的fetch实现，确保它能正确处理HTTP请求：

1. 安装node-fetch依赖：

npm install node-fetch@^2.6.7

2. 修改代码添加fetch配置：

import { initializeApp } from 'firebase/app';
import { getFirestore, collection, doc, setDoc, connectFirestoreEmulator, setFirestoreSettings } from 'firebase/firestore/lite';
import fetch from 'node-fetch';

const firebaseConfig = {
  // ... 你的配置信息
};

const app = initializeApp(firebaseConfig);
const firestoreDB = getFirestore(app);

// 配置自定义fetch，适配模拟器HTTP请求
setFirestoreSettings(firestoreDB, {
  fetch: (url, options) => {
    return fetch(url, { ...options, rejectUnauthorized: false });
  }
});

connectFirestoreEmulator(firestoreDB, 'localhost', 8080);

// 后续操作保持不变
const collectionRef = collection(firestoreDB, 'CollectionName');
const docRef = doc(collectionRef, "DocID");
setDoc(docRef, {
    name: "FieldName"
  }).then(() => 
  {
        console.log("OK");
  });

方案3：检查基础配置 #

确保：

• Firebase模拟器已正确启动（执行firebase emulators:start --only firestore）
• 代码中的项目ID与模拟器初始化时使用的项目ID完全一致
• 调用connectFirestoreEmulator时可添加参数屏蔽无关警告：

connectFirestoreEmulator(firestoreDB, 'localhost', 8080, { disableWarnings: true });

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