使用Firebase Emulator本地运行Cloud Functions失败，实际执行云端实例

我之前踩过完全一样的坑——明明模拟器日志显示函数已经被加载，结果一触发就跑到云端实例去了，折腾了半天才搞定，给你几个关键的排查和解决步骤：

1. 确认客户端调用的是本地模拟器地址 #

如果是直接发HTTP请求调用函数，别用云端的https://us-central1-<你的项目ID>.cloudfunctions.net/myGCFunction，必须换成本地模拟器的地址：http://localhost:5001/<你的项目ID>/us-central1/myGCFunction。

如果是用前端Firebase SDK的httpsCallable调用，一定要在客户端代码里加模拟器指向配置（只在开发环境生效就行）：

// 前端代码片段，放在初始化firebase之后
if (location.hostname === "localhost") {
  firebase.functions().useEmulator("localhost", 5001);
}

2. 让函数里的Admin SDK指向本地Firestore模拟器 #

因为你的函数是Firestore触发器，函数内部的Admin SDK如果还是连接云端Firestore，就会触发云端的函数实例。在你的函数代码里加上这段配置：

const admin = require('firebase-admin');
admin.initializeApp();

// 仅在模拟器环境下指向本地Firestore
if (process.env.FUNCTIONS_EMULATOR === 'true') {
  admin.firestore().settings({
    host: 'localhost:8080',
    ssl: false
  });
}

你之前设置的FIRESTORE_EMULATOR_HOST其实模拟器启动时会自动注入到函数环境，但手动加这段代码能确保万无一失。

3. 检查环境变量的生效范围 #

有时候环境变量只在当前终端会话生效，如果你是用IDE的终端或者新打开的窗口启动模拟器，可能变量没传进去。可以在启动模拟器前先重新设置一遍：

export FIRESTORE_EMULATOR_HOST=localhost:8080
export FUNCTIONS_EMULATOR=true

再执行firebase emulators:start。

4. 确保本地代码和模拟器加载的一致 #

有时候可能你本地改了代码，但模拟器还在加载旧的构建包。可以试试：

• 删除functions目录下的node_modules和lib（如果是TypeScript项目），重新npm install后再启动模拟器
• 重启模拟器时看日志，确认myGCFunction是从本地目录加载的，而不是缓存的旧版本

5. 更新Firebase CLI到最新版 #

旧版本的CLI可能存在模拟器和函数SDK的兼容性问题，先更到最新版：

npm install -g firebase-tools

最后，重启模拟器时可以用firebase emulators:start --only functions,firestore只启动需要的服务，避免其他服务干扰，同时确认端口5001、8080没有被其他进程占用。

内容的提问来源于stack exchange，提问作者Jorge Willian Alvarado Jiménez