如何通过Firebase实验性Shell批量调用Cloud Functions？

嘿，我完全懂你们的困扰——手动折腾实验性Shell来做集成测试，在大型项目里简直是效率杀手。不用去逆向Firebase工具，这里有几个实用的方案，能帮你用Shell/Bash脚本自动化调用Cloud Functions：

方案一：用functions:shell结合管道脚本自动化 #

Firebase CLI的functions:shell其实支持从标准输入读取命令，所以你可以把所有需要执行的操作（导入测试数据、调用函数）写成一个命令文件，通过管道传给shell命令，全程自动化。

举个例子，先创建一个test_commands.js文件，把要执行的操作写进去：

// 导入测试数据到Firestore（假设用Firestore，数据库类型不同写法调整）
const admin = require('firebase-admin');
await admin.firestore().collection('test-dataset').add({
  name: 'sample-item',
  value: 'test-value',
  createdAt: admin.firestore.FieldValue.serverTimestamp()
});

// 调用你的Cloud Function，比如名为`processTestData`的函数
const result = await processTestData({payload: 'test-input'});
console.log('函数执行结果:', result);

然后在Shell脚本里执行这条命令，自动完成所有操作：

cat test_commands.js | firebase functions:shell

如果需要动态生成测试数据，还可以用Bash脚本实时生成命令内容，比如用echo把变量注入到命令文件里，灵活性拉满。

方案二：直接用curl调用HTTP触发的Cloud Functions #

如果你的Cloud Functions是HTTP触发类型（用functions.https.onRequest定义），这绝对是最直接的方式——用curl在Shell脚本里发送HTTP请求就行。

1. 先获取函数的访问URL：
   • 本地测试：启动模拟器firebase serve --only functions，控制台会输出每个函数的本地URL，比如http://localhost:5001/your-project-id/us-central1/processTestData
   • 测试环境部署版：直接在Firebase控制台找到对应函数的URL
2. 然后在Shell脚本里写curl命令，带上参数和必要的认证：

# 发送POST请求，携带JSON参数
curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"payload": "automated-test-input"}' \
  http://localhost:5001/your-project-id/us-central1/processTestData

如果函数需要用户认证，可以先获取Firebase ID Token，再加入请求头：

# 用测试账号登录获取ID Token
ID_TOKEN=$(firebase auth:signInWithEmailAndPassword test-user@example.com test-password123 | grep -o '"idToken": "[^"]*"' | cut -d'"' -f4)

# 带认证头调用函数
curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ID_TOKEN" \
  -d '{"payload": "authenticated-test-input"}' \
  https://us-central1-your-project-id.cloudfunctions.net/processTestData

方案三：用Firebase Admin SDK写Node.js脚本，Shell调用 #

这个方案最灵活，适合需要复杂数据操作、多函数串联调用的场景。你可以写一个Node.js脚本，用Admin SDK完成测试数据导入、函数调用、结果校验等全流程，然后在Shell里直接运行脚本。

步骤如下：

1. 初始化脚本目录：

mkdir test-scripts && cd test-scripts
npm init -y
npm install firebase-admin firebase-functions

2. 编写integration-test.js脚本：

const admin = require('firebase-admin');
const functions = require('firebase-functions');

// 初始化Admin SDK（本地测试自动读取项目配置，部署环境需配置服务账号密钥）
admin.initializeApp();

async function runIntegrationTests() {
  try {
    // 1. 导入测试数据到数据库
    await admin.firestore().collection('test-data').doc('auto-test-doc').set({
      input: 'automated-test',
      status: 'pending'
    });

    // 2. 调用Cloud Function
    // 方式一：调用本地函数（直接导入你的函数代码）
    const { processTestData } = require('../functions/index.js');
    const localResult = await processTestData({docId: 'auto-test-doc'});
    console.log('本地函数执行结果:', localResult);

    // 方式二：调用部署的Callable函数
    const callableFunction = admin.app().functions('us-central1').httpsCallable('processTestData');
    const callableResult = await callableFunction({docId: 'auto-test-doc'});
    console.log('Callable函数执行结果:', callableResult.data);

    // 3. 校验结果（可选）
    const doc = await admin.firestore().collection('test-data').doc('auto-test-doc').get();
    if (doc.data().status === 'completed') {
      console.log('测试通过！');
    } else {
      throw new Error('测试失败：状态未更新');
    }

    // 4. 清理测试数据（可选）
    await admin.firestore().collection('test-data').doc('auto-test-doc').delete();
  } catch (error) {
    console.error('测试出错:', error);
    process.exit(1);
  }
}

runIntegrationTests();

3. 在Shell脚本里整合流程（比如启动模拟器、运行测试、关闭模拟器）：

#!/bin/bash

# 启动Functions模拟器（后台运行）
firebase emulators:start --only functions &
EMULATOR_PID=$!

# 等待模拟器启动完成
sleep 10

# 运行测试脚本
node test-scripts/integration-test.js

# 停止模拟器
kill $EMULATOR_PID

给这个脚本加执行权限：chmod +x run-tests.sh，之后一键运行./run-tests.sh就行。

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