VPS上Node.js无法使用Firebase Admin SDK，本地正常求排查方案

在本地Windows环境可正常运行的Firebase Admin SDK代码，部署到Ubuntu 22 VPS后出现以下错误：

FirebaseAppError: Credential implementation provided to initializeApp() via the "credential" property failed to fetch a valid Google OAuth2 access token with the following error: "Error fetching access token: Error while making request: .".

本地与VPS的Node版本（20.17）、firebase-admin版本（12.5.0）完全一致，且服务账号凭证的输出信息也一致。

排查方向与解决方法 #

1. 检查VPS网络连通性 #

错误提示核心是请求无法发送，优先排查网络：

• 测试VPS能否访问Google令牌服务器：

  curl -v https://oauth2.googleapis.com/token
  

  如果返回连接超时/拒绝，说明：
  • VPS的防火墙、安全组可能限制了HTTPS出站请求，需放行oauth2.googleapis.com的443端口；
  • 部分VPS服务商默认屏蔽境外IP，需联系服务商解锁Google相关域名；
  • 若使用代理，需确保Node进程正确读取代理配置（可通过设置HTTP_PROXY/HTTPS_PROXY环境变量测试）。

2. 确认服务账号文件的权限与路径 #

• 检查JSON文件的读取权限：

  ls -l ../config/test.json
  

  确保Node进程所属用户拥有该文件的读权限（可通过sudo chmod 644 ../config/test.json调整权限）。
• 验证文件路径：Linux系统区分大小写，确认代码中的路径与VPS上的实际文件路径完全匹配（包括文件名大小写）。

3. 更新系统SSL根证书 #

Linux环境下Node依赖系统根证书发起HTTPS请求，若证书缺失/过期会导致请求失败：

sudo apt update && sudo apt install ca-certificates -y

更新完成后重启Node服务。

4. 优化SDK初始化逻辑 #

• 避免重复初始化App：若VPS上存在其他代码已初始化Firebase App，会导致冲突，可修改初始化逻辑：

  let firebaseApp;
  try {
    firebaseApp = admin.app();
  } catch (e) {
    firebaseApp = admin.initializeApp({
      credential: admin.credential.cert(serviceAcc as any),
    });
  }
  

• 尝试用环境变量加载凭证：将服务账号JSON内容存入GOOGLE_APPLICATION_CREDENTIALS环境变量，然后简化初始化代码：

  admin.initializeApp();
  

5. 同步VPS系统时间 #

Google OAuth2对请求时间的准确性要求较高，若VPS时间与实际时间偏差超过5分钟，会导致令牌验证失败：

• 查看当前时间：date
• 开启自动时间同步：

  sudo timedatectl set-ntp true
  

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