Web 9版无法连接Firebase本地模拟器套件Hosting与Firestore

1. 项目ID不匹配（90%以上概率是这个问题） #

你启动模拟器时用的是demo-<PROJECT_ID>格式的演示项目ID，但前端firebaseConfig配置中的projectId仍为正式项目ID，或和你启动命令里的项目ID不一致。Firebase SDK 会根据项目ID匹配模拟器实例，ID不匹配时请求会直接被丢弃，不会抛出错误。
修复方法：
把前端firebaseConfig中的projectId修改为你启动模拟器时用的完整ID，即demo-<PROJECT_ID>，注意保留demo-前缀。

2. 模拟器连接代码执行时机晚于Firestore操作 #

如果你的代码在执行connectFirestoreEmulator之前就已经调用了Firestore的读写操作，SDK会默认连接线上正式环境，后续的连接配置不会生效。
修复方法：
保证connectFirestoreEmulator在所有Firestore相关操作之前执行，不要把连接代码放在异步逻辑、组件挂载逻辑之后。

3. 使用了未绑定模拟器的Firestore实例 #

如果你的项目多处调用了getFirestore()生成了新的Firestore实例，只有执行过connectFirestoreEmulator的实例才会连接本地模拟器，其他实例仍会连接线上环境。
修复方法：
全局复用同一个Firestore实例，不要多次调用getFirestore()，或者给所有生成的实例都执行模拟器连接逻辑。

4. 错误未被捕获导致无报错提示 #

你的写入操作可能触发了安全规则拦截、跨域等问题，但代码没有捕获Promise异常，导致控制台没有报错。
修复方法：
给所有Firestore读写操作添加异常捕获逻辑，示例代码如下：

import { addDoc, collection } from "firebase/firestore";

addDoc(collection(db, "你的集合名"), { 字段: "值" })
  .then(res => console.log("写入成功，文档ID：", res.id))
  .catch(err => console.error("写入失败：", err))

执行后查看控制台输出的错误信息针对性处理即可。

5. 验证操作 #

如果以上方法都未解决，你可以查看本地Firestore模拟器的日志文件firestore-debug.log，确认前端的请求是否发送到了模拟器：如果日志中没有对应请求记录，说明是前端连接配置问题；如果有请求记录但写入失败，可根据日志中的错误提示处理。

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