Node后端集成Firebase AppCheck遇TypeError: firebaseAdmin.appCheck is not a function

问题根源 #

你使用的firebase-admin@^9.3.0版本不支持App Check功能——App Check模块是在后续的admin SDK版本中才新增的，这个旧版本里根本没有appCheck()方法，所以无论怎么初始化都会报错。

分步解决方案 #

1. 升级firebase-admin依赖 #

先把依赖升级到支持App Check的版本，推荐直接升到最新稳定版：

npm install firebase-admin@latest

如果需要指定最低兼容版本，至少要升到v9.11.0及以上（这个版本是App Check首次加入admin SDK的版本）：

npm install firebase-admin@^9.11.0

2. 正确使用App Check功能 #

升级完成后，按以下方式初始化并验证令牌：

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

// 初始化Admin App（避免重复初始化）
if (!admin.apps.length) {
  admin.initializeApp({
    credential: admin.credential.applicationDefault()
    // 也可以用本地服务账号密钥：
    // credential: admin.credential.cert(require('./path-to-service-account.json'))
  });
}

// 获取App Check实例
const appCheck = admin.appCheck();

// 验证客户端令牌的示例函数
async function validateAppCheckToken(token) {
  try {
    const verificationResult = await appCheck.verifyToken(token);
    // 验证通过，verificationResult包含令牌的元数据（如应用ID、过期时间等）
    return { valid: true, data: verificationResult };
  } catch (err) {
    // 验证失败，可能是令牌无效、过期或格式错误
    return { valid: false, error: err.message };
  }
}

额外注意 #

• 确保你的Firebase项目已经在控制台启用了App Check，并配置了对应的验证提供者（比如ReCAPTCHA v3、Apple App Attest等）。
• 客户端发送的令牌必须是从Firebase App Check SDK获取的有效令牌，否则验证会失败。

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