使用Firebase Cloud Functions的enforceAppCheck时，是否需检查context.app == undefined？

之前在Firebase Cloud Functions中使用App Check，通常会手动在函数内部检查context.app是否存在，示例代码如下：

export const myFunction = functions.https.onCall(
  (data, context) => {
      if (context.app == undefined) {
        functions.logger.error(
          "The function must be called from an App Check verified app."
        );
        throw new functions.https.HttpsError(
          "failed-precondition",
          "The function must be called from an App Check verified app."
        );
      }

      // 后续业务逻辑
      ...
  }
);

现在Firebase提供了enforceAppCheck（以及Beta阶段的consumeAppCheckToken）配置项，示例代码如下：

const functions = require("firebase-functions/v1");

exports.yourV1CallableFunction = functions
  .runWith({
      enforceAppCheck: true, // 拒绝缺少或无效App Check令牌的请求
      consumeAppCheckToken: true  // 验证后消耗令牌（Beta功能）
  })
  .https.onCall((data, context) => {
      // context.app包含App Check的验证数据，包括应用ID
      // 后续业务逻辑
      ...
  });

结论：可以安全跳过手动检查context.app == undefined的逻辑 #

当你设置enforceAppCheck: true时，Firebase会在你的函数业务逻辑执行之前完成App Check令牌的验证流程：

• 如果请求缺少有效令牌、令牌无效或已过期，请求会直接被Firebase拦截，根本不会进入你编写的函数处理代码
• 能进入函数逻辑的请求，必然已经通过了App Check验证，context.app一定会包含有效的应用信息（如app ID）

另外，consumeAppCheckToken: true的功能也是由Firebase自动处理的，它会在验证通过后标记令牌为已使用，防止重复利用，不需要你额外编写代码。

这种新方式比手动检查更高效，也更符合Firebase的官方规范，完全可以替代旧的手动检查逻辑。

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