FirebaseAdminError: This version of the Admin SDK requires Node.js 14 or later when deploying to Cloud Functions 1st gen

Resolution: Update the Node.js Runtime Engine

To resolve the FirebaseAdminError without rewriting your functions for 2nd Gen, you must update the Node.js runtime version specified in your configuration. You do not need to change your trigger definitions (such as functions.https.onRequest) to move to a supported runtime.

Migration Steps

1. Open your functions/package.json file.
2. Locate the engines field and update the node version to "18" or "20".
3. Ensure your local development environment matches this version by running node -v.
4. Deploy the functions using the Firebase CLI.

{
  "name": "functions",
  "description": "Cloud Functions for Firebase",
  "engines": { "node": "18" },
  "dependencies": {
    "firebase-admin": "^11.0.0",
    "firebase-functions": "^4.0.0"
  }
}

Technical Explanation

The FirebaseAdminError is triggered because Firebase Admin SDK v11+ utilizes modern JavaScript features and internal dependencies that are incompatible with Node.js 12. Because Node.js 12 reached end-of-life in March 2023, the SDK explicitly blocks initialization on that runtime to prevent unstable behavior.

Runtime vs. Generation

There is a common misconception that upgrading the Node.js version requires moving from 1st Gen to 2nd Gen functions. This is incorrect. Cloud Functions 1st Gen supports Node.js 14, 16, 18, and 20. The "Generation" refers to the underlying infrastructure and trigger API (Eventarc vs. legacy), while the "Runtime" refers to the Node.js engine executing your code.

Emulator Reliability

The Firebase Local Emulator Suite runs using the Node.js version installed on your local machine. It will surface FirebaseAdminError if your local environment is running Node.js 12, but it cannot "simulate" a remote runtime mismatch if your local version is 18 while your package.json is set to 12. Always ensure your local node -v matches your engines field for reliable testing.

Compatibility Matrix

While there is no public, granular minor-version matrix, the general requirement is: Firebase Admin SDK v11.0.0+ $\rightarrow$ Node.js 14.0.0+. For production stability, Node.js 18 or 20 is recommended as older versions (14, 16) have reached or are approaching end-of-life.

Diagnostic Note: If you update the engines field and still encounter deployment errors, please verify your Firebase CLI version (firebase --version), as outdated CLI tools may fail to communicate the runtime change to Google Cloud.