Firebase v9 compat集成App Check部署Vercel报getToken未定义错误求助

云上老周

2026-9-30

报错修复方案

该报错核心由两个问题导致：v9 compat版App Check的activate方法参数格式变更，以及Vercel前端环境变量未正确暴露。

修复步骤

调整App Check激活代码
v9 compat版本不再支持直接传布尔值作为activate的第二个参数，需改为配置对象格式，替换对应代码即可：

import firebase from 'firebase/compat/app';
import 'firebase/compat/database'
import 'firebase/compat/app-check'

const config = {
  apiKey: process.env.FIREBASE_API_KEY,
  authDomain: process.env.FIREBASE_AUTH_DOMAIN,
  databaseURL: process.env.FIREBASE_DATABASE_URL,
  projectId: process.env.FIREBASE_PROJECT_ID,
  storageBucket: process.env.FIREBASE_STORAGE_BUCKET,
  messagingSenderId: process.env.FIREBASE_MESSAGING_SENDER_ID
};

if (!firebase.apps.length) {
  firebase.initializeApp(config);
  const appCheck = firebase.appCheck();
  appCheck.activate(
    process.env.GOOGLE_APP_CHECK_SITE_KEY,
    {
      isTokenAutoRefreshEnabled: true
    }
  );
}

const database = firebase.database();
export { firebase, database as default };

配置Vercel环境变量
进入Vercel对应项目的环境变量管理页：

确认已添加GOOGLE_APP_CHECK_SITE_KEY变量，值为你的reCAPTCHA v3公钥
开启该变量的「Expose to Browser」选项，否则前端代码运行时无法读取到变量值

SSR框架额外适配（如Next.js）
如果项目使用SSR/SSG框架，需限制App Check仅在浏览器端初始化，避免服务端无浏览器环境报错：

// 新增window环境判断
if (!firebase.apps.length && typeof window !== 'undefined') {
  firebase.initializeApp(config);
  const appCheck = firebase.appCheck();
  appCheck.activate(
    process.env.GOOGLE_APP_CHECK_SITE_KEY,
    {
      isTokenAutoRefreshEnabled: true
    }
  );
}