部署在Cloud Run的Firebase Admin SDK是否需要GOOGLE_CLOUD_PROJECT环境变量？

两类方法行为不一致的根本原因 #

• createCustomToken方法全程本地计算，无需调用远程接口
  该方法的核心逻辑是使用服务账号私钥在本地签名生成JWT，不需要请求Firebase Auth后端服务。生成JWT所需的项目ID可以直接从服务账号的client_email字段（格式为{服务账号标识}@{项目ID}.iam.gserviceaccount.com）中解析提取，不需要额外读取环境变量或其他配置项。
• setCustomUserClaims方法依赖远程API调用，必须明确获取项目ID
  该方法需要向Firebase Auth服务端发起REST请求，请求路径中必须携带项目ID（接口路径规则为/v1/projects/{项目ID}/accounts:update）。此时Firebase Admin SDK会按固定优先级查找项目ID：
  1. 初始化SDK时显式传入的projectId参数
  2. 服务账号凭证文件中自带的project_id字段
  3. GOOGLE_CLOUD_PROJECT环境变量
     当服务部署在Cloud Run时，默认使用运行时自动分配的服务账号，SDK获取到的是GCP元数据服务下发的临时凭证，这类凭证不携带project_id字段。如果既没有在初始化时显式指定项目ID，也没有配置GOOGLE_CLOUD_PROJECT环境变量，SDK就会抛出对应的项目ID查找失败错误。

是否需要配置GOOGLE_CLOUD_PROJECT环境变量 #

建议配置，原因如下：

• 所有需要调用Firebase/GCP后端API的Admin SDK方法（包括但不限于setCustomUserClaims、用户信息查询/修改、IDToken后端校验、Firestore/Cloud Storage操作等）都依赖项目ID配置，统一配置环境变量可以避免后续其他方法出现同类报错。
• Cloud Run运行时默认会自动注入该环境变量，主动配置可以覆盖异常场景下的默认值缺失问题，保障服务稳定性。
• 除了配置环境变量，也可以选择在初始化SDK时显式传入projectId参数，优先级高于环境变量，更适配多项目部署等特殊场景，示例如下：

// Node.js 环境显式指定项目ID初始化Admin SDK
const admin = require('firebase-admin');
admin.initializeApp({
  projectId: '你的GCP项目ID'
});

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