如何在本地测试Eventarc？Firebase转Cloud Run的触发测试方案咨询

针对你提到的迁移场景，以下是几种实用的本地测试方案，无需依赖尚未完善的Eventarc全链路模拟器：

1. 手动构造Eventarc事件请求本地服务 #

Eventarc本质是通过HTTP POST将事件payload发送到目标服务，可直接构造符合Firestore事件格式的JSON请求，手动触发本地运行的Cloud Run服务：

• 参考GCP Firestore事件结构编写测试用JSON（示例firestore-event.json）：

{
  "id": "test-event-id",
  "type": "google.cloud.firestore.document.v1.created",
  "specversion": "1.0",
  "source": "//firestore.googleapis.com/projects/test-project/databases/(default)/documents/orders/test-order",
  "subject": "documents/orders/test-order",
  "time": "2024-05-20T12:00:00Z",
  "data": {
    "oldValue": null,
    "value": {
      "createTime": "2024-05-20T12:00:00Z",
      "fields": {
        "userId": { "stringValue": "user123" },
        "total": { "integerValue": "99" }
      },
      "name": "projects/test-project/databases/(default)/documents/orders/test-order",
      "updateTime": "2024-05-20T12:00:00Z"
    }
  }
}

• 启动本地Cloud Run服务（如docker run -p 8080:8080 your-image），用curl发送请求：

curl -X POST -H "Content-Type: application/json" -d @firestore-event.json http://localhost:8080

• 可将不同场景的事件存为JSON文件，方便重复测试。

2. 结合Firebase模拟器+自定义监听脚本 #

利用Firebase Firestore模拟器的本地监听能力，写一个简单脚本监听文档变更，自动构造Eventarc事件触发本地服务：

• 启动Firebase Firestore模拟器：firebase emulators:start --only firestore
• 编写Node.js监听脚本（其他语言同理）：

const { initializeApp } = require('firebase-admin/app');
const { getFirestore } = require('firebase-admin/firestore');
const fetch = require('node-fetch');

// 连接本地Firestore模拟器
initializeApp({ projectId: 'test-project' });
const db = getFirestore({ host: 'localhost:8080', ssl: false });

// 监听orders集合变更
db.collection('orders').onSnapshot(snapshot => {
  snapshot.docChanges().forEach(change => {
    // 匹配Eventarc事件类型
    let eventType;
    switch (change.type) {
      case 'added': eventType = 'google.cloud.firestore.document.v1.created'; break;
      case 'modified': eventType = 'google.cloud.firestore.document.v1.updated'; break;
      case 'removed': eventType = 'google.cloud.firestore.document.v1.deleted'; break;
    }

    // 构造Eventarc事件payload
    const event = {
      id: `local-event-${Date.now()}`,
      type: eventType,
      specversion: '1.0',
      source: `//firestore.googleapis.com/projects/test-project/databases/(default)/documents/${change.doc.ref.path}`,
      subject: change.doc.ref.path,
      time: new Date().toISOString(),
      data: {
        value: change.doc.data(),
        oldValue: change.type !== 'added' ? change.oldDoc?.data() : null
      }
    };

    // 触发本地Cloud Run服务
    fetch('http://localhost:8080', {
      method: 'POST',
      body: JSON.stringify(event),
      headers: { 'Content-Type': 'application/json' }
    }).then(res => console.log(`Event sent: ${res.status}`));
  });
});

• 运行脚本后，在Firebase模拟器UI中修改文档，即可自动触发本地服务。

3. 使用Cloud Code插件实现半自动化触发 #

若使用VS Code或IntelliJ，可借助Cloud Code插件简化流程：

• 安装Cloud Code插件，配置本地Cloud Run服务运行环境
• 在插件中添加Eventarc触发器配置，选择Firestore事件类型并关联本地服务
• 启动Firebase Firestore模拟器后，通过Cloud Code启动本地服务，模拟器中的Firestore变更会自动路由到本地服务。

4. 临时公网暴露本地服务（接近生产环境测试） #

若需验证完整Eventarc流程，可用ngrok把本地服务暴露为公网HTTPS地址：

• 启动本地服务后运行ngrok http 8080获取公网地址
• 在GCP控制台创建临时Eventarc触发器，目标服务填该ngrok地址
• 使用测试环境Firestore或配置指向GCP测试项目的Firebase模拟器做文档变更，Eventarc会将事件发送到本地服务
• 测试完成后务必删除触发器，避免产生不必要费用。

关于Eventarc模拟器现状 #

目前GCP的Eventarc模拟器仍在优化本地触发器绑定体验，尚未实现Firebase Functions那样的自动关联，但上述方案均为当前可落地的高效替代方案。

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