开发环境中Firestore结合Cloud Functions实时更新失效问题

我之前也碰到过一模一样的情况——本地用firebase serve跑的时候，Firestore的实时更新触发器完全没反应，但部署到生产环境就一切正常。结合你的代码和场景，给你几个实用的排查方向：

1. 先把Firebase CLI和模拟器更到最新 #

旧版本的模拟器经常会有兼容性bug，先执行这条命令更到最新版试试：

npm install -g firebase-tools

同时检查firebase.json里的模拟器配置，确保Firestore和云函数的模拟器都正确启用了，比如：

{
  "emulators": {
    "functions": {
      "port": 5001
    },
    "firestore": {
      "port": 8080
    },
    "ui": {
      "enabled": true
    }
  }
}

2. 测试时一定要用本地模拟器的Firestore #

很多人会犯这个低级错误：开着本地模拟器，但测试时却去修改生产环境的Firestore数据，这样本地触发器当然不会触发！

• 如果你用控制台测试，一定要打开本地模拟器UI（默认地址是http://localhost:4000），在这个UI里操作users集合的文档，别去生产环境的Firebase控制台点。
• 如果是代码测试，要给客户端SDK加一段模拟器连接配置，比如Web SDK：

  if (location.hostname === "localhost") {
    firebase.firestore().useEmulator("localhost", 8080);
    firebase.functions().useEmulator("localhost", 5001);
  }
  

3. 检查你的函数代码细节 #

看了你的代码，发现两个小问题：

• 日志语句用了单引号，模板字符串得用反引号才能解析${userId}，不然控制台只会输出New apply <${userId}>这个字符串，根本看不到实际的userId。
• 返回字符串"Done."虽然没问题，但云函数更推荐返回Promise，避免异步逻辑的潜在问题。

调整后的规范代码：

exports.onApplyCreated = functions.firestore
  .document('users/{userId}')
  .onWrite((change, context) => {
    const data = change.after.data();
    const userId = context.params.userId;
    console.log(`New apply <${userId}>`);
    return Promise.resolve("Done.");
  });

另外还要确认你操作的是users集合下的文档，别把集合名拼错（比如写成user少了s）。

4. 换个方式看日志 #

有时候firebase serve的shell日志不全，你可以单独启动模拟器查看详细输出：

firebase emulators:start --only functions,firestore

或者打开模拟器UI的「Functions」标签页，那里会显示更完整的触发器触发日志，能看到有没有报错或者触发器没注册成功的信息。

5. 确认函数已加载到模拟器 #

执行firebase serve时，要确保控制台输出了类似Function onApplyCreated ready on http://localhost:5001/xxx/us-central1/onApplyCreated的信息，这说明函数已经成功加载到模拟器里了。如果没看到这条，大概率是代码有语法错误，再检查一遍代码拼写。

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