Fastify框架下NodeJS创建Firebase自定义令牌遇问题求助

关键要点澄清 #

• getAuth()确实属于firebase-admin SDK，和前端Firebase客户端SDK是完全不同的工具链
• 从Firebase控制台获取的前端firebaseConfig不能直接用于Admin SDK初始化，Admin SDK需要服务账号凭证而非客户端配置

步骤1：安装依赖 #

在Fastify项目中安装Firebase Admin SDK：

npm install firebase-admin

步骤2：获取服务账号凭证 #

1. 打开Firebase控制台，进入目标项目
2. 左侧菜单点击「设置」>「服务账号」
3. 点击「生成新的私钥」，下载JSON格式的服务账号文件
4. 将文件放置到Fastify项目的安全目录（例如./service-account.json，务必添加到.gitignore避免泄露）

步骤3：正确初始化Firebase Admin #

替换你之前错误的初始化代码，使用服务账号凭证完成初始化：

const admin = require('firebase-admin');
const serviceAccount = require('./service-account.json');

// 初始化Admin SDK
admin.initializeApp({
  credential: admin.credential.cert(serviceAccount)
});

// 调用getAuth()获取Auth实例
const auth = admin.getAuth();

如果你的Fastify服务部署在GCP托管服务（如Cloud Run、App Engine），可以省略服务账号文件，直接使用默认应用凭证：

admin.initializeApp();

步骤4：在Fastify路由中生成自定义令牌 #

创建接口用于生成自定义令牌，示例代码：

const fastify = require('fastify')({ logger: true });

// 上述Admin初始化代码需放在此处

fastify.post('/create-custom-token', async (request, reply) => {
  const { uid } = request.body; // 传入你的业务系统用户唯一标识
  try {
    // 生成自定义令牌
    const customToken = await auth.createCustomToken(uid);
    return { customToken };
  } catch (error) {
    reply.code(500).send({ error: error.message });
  }
});

// 启动Fastify服务
fastify.listen({ port: 3000 }, (err) => {
  if (err) throw err;
});

错误原因说明 #

你遇到的auth/invalid-credential错误，本质是Admin SDK需要服务账号的签名权限来生成自定义令牌，而前端firebaseConfig仅包含客户端身份信息，不具备服务端操作所需的权限，因此必须使用服务账号凭证完成初始化。

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