This is a glossary of all the common issues in Firebase - Firebase Admin Node
  • 01-Jan-2023
Lightrun Team
Author Lightrun Team
This is a glossary of all the common issues in Firebase - Firebase Admin Node

Troubleshooting Common Issues in Firebase – Firebase Admin Node

Lightrun Team
Lightrun Team

Project Description


Firebase Admin Node.js is a Node.js library that provides an easy-to-use interface for performing common tasks related to Firebase projects, such as generating access tokens, sending push notifications, and managing Firebase Realtime Database data.

The library is designed for use in server-side environments, and it provides full access to the Firebase platform’s functionality without the need for a client-side app.

This means that you can use the Firebase Admin Node.js library to perform tasks that would normally require a client app to authenticate with Firebase, such as reading and writing data to the Firebase Realtime Database, or sending push notifications to mobile devices.


Troubleshooting Firebase – Firebase Admin Node with the Lightrun Developer Observability Platform


Getting a sense of what’s actually happening inside a live application is a frustrating experience, one that relies mostly on querying and observing whatever logs were written during development.
Lightrun is a Developer Observability Platform, allowing developers to add telemetry to live applications in real-time, on-demand, and right from the IDE.
  • Instantly add logs to, set metrics in, and take snapshots of live applications
  • Insights delivered straight to your IDE or CLI
  • Works where you do: dev, QA, staging, CI/CD, and production

The most common issues for Firebase – Firebase Admin Node are:


FR: Divide “messaging/registration-token-not-registered” error into more specific parts.


The “messaging/registration-token-not-registered” error in the Firebase Admin Node.js library occurs when you try to send a message to a device using a registration token that is no longer valid. This can happen for a variety of reasons, such as:

  1. The app on the device has been uninstalled.
  2. The device has been factory reset.
  3. The device has been signed out of the app.
  4. The device has been disabled.

To handle this error, you can check the specific cause by looking at the errorInfo field of the error object that is returned by the sendToDevice method. This field contains an array of objects, each of which represents a specific error that occurred while trying to send the message.

Here’s an example of how you might check the errorInfo field to handle the “messaging/registration-token-not-registered” error:

try {
  const response = await admin.messaging().sendToDevice(registrationToken, message);
  console.log(`Successfully sent message: ${response}`);
} catch (error) {
  if (error.code === 'messaging/registration-token-not-registered') {
    // Check the error info field to see which tokens are not registered
    error.errorInfo.forEach((errorInfo) => {
      console.log(`Token ${errorInfo.index} is not registered`);
  } else {
    console.log(`Error sending message: ${error}`);


More issues from Firebase repos


Troubleshooting firebase-firebase-tools | Troubleshooting firebase-firebase-android-sdk |Troubleshooting firebase-firebase-ui-web


It’s Really not that Complicated.

You can actually understand what’s going on inside your live applications.

Try Lightrun’s Playground

Lets Talk!

Looking for more information about Lightrun and debugging?
We’d love to hear from you!
Drop us a line and we’ll get back to you shortly.

By submitting this form, I agree to Lightrun’s Privacy Policy and Terms of Use.