如何用Cloud Functions Shell本地运行带Auth上下文的Firebase HTTPS可调用函数

我之前也碰到过一模一样的问题，官方指南里确实没把这个场景讲透。其实要在Cloud Functions Shell里测试带Auth的onCall函数，核心就是手动模拟auth上下文，同时配合Firestore模拟器避免影响生产数据。下面是完整的实操步骤：

1. 配置本地环境 #

首先确保你装了最新版的firebase-tools，并且Functions项目已经初始化了Firebase Admin SDK。如果还没配置Admin，记得在functions/index.js里加上初始化代码：

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

为了让本地函数自动连接到Firestore模拟器（而非生产环境），建议添加这段环境判断：

// 本地模拟器模式下切换Firestore连接
if (process.env.FUNCTIONS_EMULATOR === 'true') {
  admin.firestore().settings({
    host: 'localhost:8080',
    ssl: false
  });
}

2. 启动带Firestore模拟器的Functions Shell #

打开终端进入你的Functions项目目录，运行以下命令启动Shell，同时启动Firestore模拟器：

firebase functions:shell --emulators firestore

启动成功后，Shell会列出所有可用的函数（包括你的myFunction），等待你输入调用指令。

3. 模拟Auth上下文调用函数 #

本地Shell不会自动生成Auth上下文，所以调用myFunction时需要手动传入第二个参数（即context对象）。调用格式如下：

myFunction({ message: "你的测试消息内容" }, { auth: { uid: "test-user-123" } })

如果你的函数需要更多Auth字段（比如用户邮箱），可以扩展auth对象：

myFunction(
  { message: "测试带邮箱的场景" }, 
  { 
    auth: { 
      uid: "test-user-456", 
      token: { email: "test@example.com" } 
    } 
  }
)

4. 验证测试结果 #

调用后Shell会返回函数的执行结果，你还可以打开Firestore模拟器的UI（默认地址http://localhost:8080），查看对应的数据是否已经正确保存到Firestore中。

注意事项 #

• 本地模拟器会跳过Firestore安全规则检查，若要测试规则，需单独启动Firestore模拟器并配置规则文件。
• 模拟的Auth上下文仅用于本地业务逻辑测试，和生产环境的Auth验证逻辑无关，不要用它测试权限校验。

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