Firebase+Gemini应用令牌刷新500错误求助（编程新手）

排查方向1：检查服务账号密钥有效性 #

• 登录Firebase控制台，进入「项目设置」>「服务账号」
• 重新生成JSON格式的服务账号密钥，替换项目中旧密钥文件
• 确认Next.js项目环境变量（如GOOGLE_APPLICATION_CREDENTIALS）指向新密钥路径，或直接将密钥内容存入环境变量（注意切勿泄露密钥）

排查方向2：验证服务账号权限 #

• 检查服务账号的角色权限，确保拥有「Editor」或业务所需的具体权限（如Firebase Auth、Firestore访问权限）
• 确认是否误修改了项目IAM权限，导致服务账号无法获取令牌

排查方向3：规范Admin SDK初始化代码 #

确保初始化代码无错误配置，避免重复初始化：

import admin from "firebase-admin";

if (!admin.apps.length) {
  admin.initializeApp({
    // 两种初始化方式二选一
    credential: admin.credential.applicationDefault(),
    // credential: admin.credential.cert(require('./service-account-key.json'))
  });
}

export const firebaseAdmin = admin;

• 使用applicationDefault时，需确保Firebase App Hosting的默认服务账号权限正常
• 必须通过apps.length判断避免重复初始化App

排查方向4：同步部署环境配置 #

• 重新部署应用，确保新配置（密钥、环境变量）已同步到Firebase Hosting
• 更新Firebase CLI到最新版本后再部署：npm install -g firebase-tools

本地测试定位问题 #

本地运行时，设置环境变量指向服务账号密钥，执行firebase emulators:start模拟生产环境，验证是否仍出现相同错误，以此区分是本地配置还是部署环境问题

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