本地运行Firebase Emulator时Pub/Sub云函数未显示如何解决

算力阿峰

2026-8-30

问题描述

本地启动Firebase Emulator调试Firebase Cloud Functions时，已编写完成的云函数未在模拟器中正常展示。
对应函数代码如下：

const functions = require("firebase-functions");
const admin = require("firebase-admin");
const DomParser = require('dom-parser')

admin.initializeApp(functions.config().firebase);

exports.storeBooking = functions
  .region("europe-west1")
  .pubsub.topic("responses")
  .onPublish((message) => {
/// some logic
  });

正常启动模拟器后应当展示名为storeBooking的云函数，但实际运行时输出如下日志，提示函数因Pub/Sub模拟器不存在或未运行被忽略，无法正常识别加载：

Watching "D:\backend-functions\booking" for Cloud Functions...
function ignored because the pubsub emulator does not exist or is not running.
function ignored because the pubsub emulator does not exist or is not running.

产生原因

该报错的核心触发原因是启动Firebase模拟器时，没有同步启动Pub/Sub模拟器组件。Functions模拟器启动时会自动校验所有触发类型依赖的对应模拟器是否运行，对于依赖Pub/Sub触发的函数，如果检测不到运行中的Pub/Sub模拟器，会直接跳过这类函数的加载，输出对应忽略提示。
日志重复打印两次属于旧版Firebase CLI的已知输出bug，不影响问题本身的定位。

解决方法

临时启动方案：启动模拟器时显式指定需要同时启动Functions和Pub/Sub组件，在项目根目录执行以下命令即可：
```
firebase emulators:start --only functions,pubsub
```
永久配置方案：修改项目根目录下的firebase.json配置文件，在emulators配置块中添加Pub/Sub模拟器的端口声明，参考配置如下：
```
{
  "emulators": {
    "functions": {
      "port": 5001
    },
    "pubsub": {
      "port": 8085
    },
    // 其余已配置的模拟器项，如firestore、auth、hosting等可保留不动
  }
}
```
配置保存后，直接执行常规启动命令firebase emulators:start就会自动拉起Pub/Sub模拟器，被忽略的storeBooking函数会正常加载展示。
版本兼容处理：如果上述配置完成后仍存在识别异常，先将全局安装的Firebase CLI升级到最新版本，旧版本CLI存在偶发的组件识别故障，升级命令如下：
```
npm install -g firebase-tools
```

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