Firebase本地模拟器无法监听Google Cloud Pub/Sub消息求助

核心问题 #

你当前用gcloud命令把消息发送到了云端的Pub/Sub主题，但本地运行的Functions模拟器默认监听的是本地Pub/Sub模拟器的主题，两者不连通，所以函数收不到消息。

修复步骤 #

1. 启动包含Pub/Sub的本地模拟器 #

启动Firebase模拟器时必须同时加载Pub/Sub组件，命令如下：

firebase emulators:start --only functions,pubsub

启动后终端会输出Pub/Sub模拟器的地址（通常是http://localhost:8085），后续操作需要用到这个地址。

2. 在本地模拟器中创建目标主题 #

用gcloud命令连接本地模拟器创建主题，而非云端：

gcloud pubsub topics create subscription-listener --project <MY_CLOUD_PROJECT_NAME> --endpoint http://localhost:8085

注意<MY_CLOUD_PROJECT_NAME>必须和你的Firebase项目ID完全一致。

3. 规范Functions的主题引用（可选） #

对于v2版本的Functions，建议使用完整的主题资源路径，避免匹配歧义：

import { pubsub, logger } from "firebase-functions/v2";

export const helloWorld = pubsub.onMessagePublished(
  `projects/<MY_CLOUD_PROJECT_NAME>/topics/subscription-listener`,
  (event) => {
    console.log("Event: ", event.data);
    logger.log("Event: ", event.data);
    // 可选：解码Base64格式的消息内容
    const decodedMsg = event.data.message.data 
      ? Buffer.from(event.data.message.data, 'base64').toString() 
      : '无消息内容';
    console.log("解码后消息: ", decodedMsg);
  }
);

4. 发送消息到本地Pub/Sub模拟器 #

使用gcloud命令指定本地端点发送测试消息：

gcloud pubsub topics publish subscription-listener --message '{"name":"Xenia"}' --project <MY_CLOUD_PROJECT_NAME> --endpoint http://localhost:8085

5. 确认函数监听状态 #

启动模拟器后，检查终端输出，确保helloWorld函数被成功注册为Pub/Sub触发器，出现类似Function helloWorld registered for event pubsub.topic.publish的提示。

额外注意事项 #

• 本地凭据无需指向云端管理员账号，Firebase CLI会自动提供本地模拟器所需的凭据。
• 若端口冲突，可在firebase.json中修改Pub/Simulator端口：

{
  "emulators": {
    "pubsub": {
      "port": 8086
    }
  }
}

内容的提问来源于stack exchange，提问作者Danh Đào Thanh