Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Datastore emulator causes firebase admin to hang

Open
#790 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
35/100
Issue type
Bug
Clarity
Needs clarification
Activity status
Stale
Tech stack
python

Research direction

Start by running the datastore emulator commands from the report and the provided Python script, focusing on the transition from datastore_client.context() to auth.get_user_by_email(). Compare behavior with the three datastore context lines removed. Done means the Firebase Auth lookup returns normally while the datastore emulator is running, and the process remains interruptible.

Written by the indexing model from the issue text.

Description

api: auth
[REQUIRED] Step 2: Describe your environment
  • Operating System version: Mac 14.5
  • Firebase Product: firebase-admin==6.2.0 and firebase-admin==6.5.0
  • Python version: 3.11.4
  • Pip version: 24.0
[REQUIRED] Step 3: Describe the problem
Steps to reproduce:

This problem started around June 1. Before, I have been doing this for several years without any issues.

The problem is that auth.get_user_by_email() freezes and it is caused by some interaction with running the cloud datastore emulator locally. This happens with either the older emulator (gcloud beta emulators datastore start) or the newer one (gcloud emulators firestore start ). I have tried downgrading gcloud and two versions of firebase-admin listed above.

Run the script below. At auth.get_user_by_email(), the script hangs indefinitely with no output. You can't even ctrl-c to stop the script. You need to kill -9 in a separate terminal window.

If you comment out the three lines starting with with datastore_client.context():, then auth.get_user_by_email() works.

Since the code just freezes, I am at a loss as to how to debug.

Relevant Code:
import os
from google.cloud import ndb
import firebase_admin
from firebase_admin import auth, initialize_app

print('starting')

class User(ndb.Model):
    email = ndb.StringProperty(required=True)

os.environ['DATASTORE_DATASET'] = 'my-project'
os.environ['DATASTORE_EMULATOR_HOST'] = 'localhost:8081'
os.environ['DATASTORE_EMULATOR_HOST_PATH'] = 'localhost:8081/datastore'
os.environ['DATASTORE_HOST'] = 'http://localhost:8081'
os.environ['DATASTORE_PROJECT_ID']= 'my-project'

datastore_client = ndb.Client('my-project')

if not firebase_admin._apps:
    initialize_app()

email = 'me@example.com'

with datastore_client.context():
    user = User.get_by_id(email)
    print(user)

# This hangs and you can't even ctrl-c to stop.
# Works if datastore client stuff is commented out.
fb_user = auth.get_user_by_email(email)
print(fb_user)
Dominant language
Python
Stars
1.2k
Forks
359
Avg merge
3d 9h
Merged PRs (30d)
3

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from firebase/firebase-admin-python

All issues in firebase/firebase-admin-python

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.