App Check (Play Integrity) token request never completes after Play Store self-update; Auth and Realtime Database hang with it

Open
#8,802 2 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
43/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Active
Tech stack
android, java

Research direction

Start by reading the App Check token caching and provider installation behavior described for DefaultFirebaseAppCheck in the issue, then trace the Play Integrity provider request path and its service binding. The issue reports no reproducer, so first investigate how a Play Store package update affects an in-flight request. Done means requests recover or fail instead of remaining pending, with coverage for the failure path.

Written by the indexing model from the issue text.

Description

api: app-check api: auth api: database
[REQUIRED] Step 2: Describe your environment
  • Android Studio version: not relevant (AGP 8.13.2)
  • Firebase Component: App Check (Play Integrity provider), Auth, Realtime Database
  • Component version: BoM 34.19.0 → firebase-appcheck 19.4.1, firebase-appcheck-playintegrity 19.4.1, com.google.android.play:integrity 1.4.0, firebase-auth 24.2.0, firebase-database 22.0.2, play-services-tasks 18.4.1
  • Device: Samsung Galaxy Tab S5e (SM-T720), Android 13, screen permanently on, not in Doze, app exempt from battery optimization
  • Play Store: 53.9.23-31, self-updated while our app was running
[REQUIRED] Step 3: Describe the problem

After the Play Store updated itself in the background, the App Check token request never completed – neither success nor failure. Because Firebase Auth waits for the App Check token without a timeout, the ID token request hung as well, and the Realtime Database stayed disconnected for more than 75 minutes although the network was fine. Only restarting the app process fixed it.

App Check is not enforced for any product in our project, so the app had no reason to wait at all.

Timeline (device time)
  • 06:09:42 Play Store update installed. System log: Force stopping com.android.vending … installPackageLI, then Force stopping service ServiceRecord{… com.android.vending/com.google.android.finsky.integrityservice.IntegrityService} (pkg removed). The new Play Store process started at 06:10:07.
  • 06:27:07 Realtime Database reports disconnected (around the time the cached tokens expired).
  • 06:29:29 Our watchdog calls FirebaseAppCheck.getAppCheckToken(false) and FirebaseUser.getIdToken(false). Neither task ever completes. Logged every 5 minutes until 07:44: request still open after 4502 s for both.
  • During that time: DNS and TCP to the database host and firestore.googleapis.com work (20 ms), network is validated, no Doze, screen on. Three goOffline()/goOnline() cycles do not help.
  • 07:48 App process restarted → database connected within 4 seconds.
Thread dump while hanging (jdb, debug build)

Six threads like this one, all in Firebase Auth waiting for a task:

Firebase Blocking Thread #106:
  [6] java.util.concurrent.CountDownLatch.await (CountDownLatch.java:232)
  [7] com.google.android.gms.tasks.zzaa.zza (com.google.android.gms:play-services-tasks@@18.4.1:1)
  [8] com.google.android.gms.tasks.Tasks.await (com.google.android.gms:play-services-tasks@@18.4.1:8)
  [9] com.google.android.gms.internal.firebase-auth-api.zzafj.zza (com.google.firebase:firebase-auth@@24.2.0:9)
  [10] com.google.android.gms.internal.firebase-auth-api.zzafj.zza (com.google.firebase:firebase-auth@@24.2.0:59)
  [11] com.google.android.gms.internal.firebase-auth-api.zzagd.zza (com.google.firebase:firebase-auth@@24.2.0:59)
  [12] com.google.android.gms.internal.firebase-auth-api.zzafk.zza (com.google.firebase:firebase-auth@@24.2.0:49)
  [13] com.google.android.gms.internal.firebase-auth-api.zzaba.zzb (com.google.firebase:firebase-auth@@24.2.0:108)
  [14] com.google.android.gms.internal.firebase-auth-api.zzaet.zzb (com.google.firebase:firebase-auth@@24.2.0:86)
  [15] com.google.android.gms.internal.firebase-auth-api.zzadg.zza (com.google.firebase:firebase-auth@@24.2.0:13)
  [16] com.google.android.gms.internal.firebase-auth-api.zzafw.run (com.google.firebase:firebase-auth@@24.2.0:3)

The IntegrityService handler thread in our process was idle (MessageQueue.nativePollOnce), i.e. no answer from the Play Store ever arrived.

Why the app cannot recover on its own

From the bytecode of firebase-appcheck 19.4.1:

  1. DefaultFirebaseAppCheck.getToken(boolean) reuses cachedTokenTask as long as it is neither complete nor cancelled – also with forceRefresh = true. A provider task that never finishes therefore blocks every later App Check request for the lifetime of the process.
  2. installAppCheckProviderFactory() replaces the provider but does not reset cachedTokenTask, so installing the factory again does not help either.
  3. Firebase Auth waits for the App Check token with Tasks.await() without a timeout, so the hang spreads to Auth and from there to the Realtime Database.

Our guess for the root cause is that the Play Integrity client (IntegrityManagerFactory.create()) keeps its connection to the IntegrityService of the old Play Store package and does not rebind after the package was replaced, so the request is queued forever. We have not been able to confirm this from the outside.

Expected behavior
  • The Play Integrity provider rebinds after the Play Store was updated, or fails the task with an error (e.g. CANNOT_BIND_TO_SERVICE).
  • In any case, App Check token requests time out instead of staying pending forever, and Auth does not block on App Check without a timeout.
Steps to reproduce

We saw this once and have not reproduced it on purpose. What happened:

  1. App with App Check (Play Integrity provider), Auth and Realtime Database, running as a long-lived foreground service.
  2. Play Store updates itself while the app keeps running.
  3. Wait until the cached App Check token has to be renewed (e.g. on the next database reconnect).
  4. getAppCheckToken() never completes; getIdToken() and the database connection hang with it.
Relevant Code
FirebaseApp.initializeApp(context);
FirebaseAppCheck.getInstance().installAppCheckProviderFactory(PlayIntegrityAppCheckProviderFactory.getInstance());
// later, after the Play Store update:
FirebaseAppCheck.getInstance().getAppCheckToken(false)   // never completes
FirebaseAuth.getInstance().getCurrentUser().getIdToken(false)  // never completes

Workaround on our side: we are removing App Check, as it is not enforced for our project anyway.

Dominant language
Java
Stars
2.6k
Forks
733
Avg merge
2d 15h
Merged PRs (30d)
72

Getting set up

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-android-sdk

All issues in firebase/firebase-android-sdk

Similar issues

More Java issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.