Flutter: FirebaseException No AppCheckProvider installed
com.google.firebase.FirebaseException: No AppCheckProvider installedShort answer
Firebase App Check needs a provider chosen in your Dart code before other Firebase calls run. This error means no provider was ever activated, or activation ran in the wrong place. Call FirebaseAppCheck.instance.activate right after Firebase.initializeApp, with the debug provider for emulators and development builds.
Fix it fast
1Find out which cause you have
Search the project for the activate call. If nothing is found, or it sits after code that already uses Firebase, that is the cause.
grep -rn "FirebaseAppCheck.instance.activate" lib/2Match what you see, then jump to its fix
- 1
The grep finds nothing, or the call is not directly after initializeAppactivate() is never called, or called too lateFix - 2
FirebaseAppCheck is an undefined name, or the native side was never built with the pluginThe firebase_app_check package is not in the app yetFix - 3
The error or App Check rejections appear only on emulators, CI, or debug buildsAn emulator or development build cannot be attestedFix
- 1
What does the error look like?
com.google.firebase.FirebaseException: No AppCheckProvider installed
Cause 1 of 3
activate() is never called, or called too late
1Check
Open main.dart and look at the order of calls before runApp.
grep -n "initializeApp\|activate\|runApp" lib/main.dart2Fix
Initialize Firebase first, then activate App Check, then use any other Firebase service. Android uses Play Integrity by default, and Apple platforms take an appleProvider.
await Firebase.initializeApp(
options: DefaultFirebaseOptions.currentPlatform,
);
await FirebaseAppCheck.instance.activate(
appleProvider: AppleProvider.appAttest,
);3Verify
Rebuild with a full run, then trigger the Firebase call that failed.
flutter runConfirmed by firebase.google.com
Cause 2 of 3
The firebase_app_check package is not in the app yet
1Check
Look for the package in pubspec.yaml.
grep -n "firebase_app_check" pubspec.yaml2Fix
Add the package and rebuild the app. Hot reload does not install a new native plugin.
flutter pub add firebase_app_check
flutter run3Verify
The import resolves and the app starts without the exception.
flutter analyzeConfirmed by firebase.google.com
Cause 3 of 3
An emulator or development build cannot be attested
1Check
Real attestation providers only accept genuine devices and store-installed apps. Confirm whether you are running on an emulator.
flutter devices2Fix
Use the debug provider for development, read the debug secret the app prints in logcat, and register it under App Check, Apps, Manage debug tokens in the Firebase console. Never ship the debug provider or commit the token.
await FirebaseAppCheck.instance.activate(
androidProvider: AndroidProvider.debug,
);3Verify
Run the app, find the line starting DebugAppCheckProvider in the logs, and register that token.
adb logcat | grep DebugAppCheckProviderConfirmed by firebase.google.com
How do I stop it coming back?
- Keep Firebase.initializeApp and FirebaseAppCheck.instance.activate together in main(), in that order.
- Switch providers by build mode, so release builds never use the debug provider.
- Turn on enforcement only after the metrics show your real clients send valid tokens.
Sources
How was this page made?
I drafted this page with AI assistance from the official documents listed under Sources. Every cause above names the document that confirms it. I have not reproduced this fix on a machine of my own yet, so read it as documented guidance, not a test report. Found a mistake? Tell me.
Which stack is behind this page?
Projects of mine built on the same technologies:
- SessionBirdAn omnichannel engagement suite in Flutter: campaigns, chatbot, tickets, analytics and live calling.
- WorkforceA field app, an admin console and a self-hosted Node.js server for push and reconciliation.
- Spotless LaundryAn on-demand laundry app: Flutter on a Laravel back end, with Firebase for live updates.
Related fixes
Mobile apps
Gradle cannot find com.google.firebase:firebase-analytics-ktx
Required by: project :app
Firebase moved the Kotlin extensions into the main modules and stopped releasing the -ktx modules in July 2025.
2 causes, each with a fixMobile apps
Firestore returns permission-denied: Missing or insufficient permissions
FirebaseError: [code=permission-denied]: Missing or insufficient permissions.
Firestore rejected the request because your security rules, or App Check enforcement, did not allow it.
4 causes, each with a fixMobile apps
Flutter Android: Failed to load FirebaseOptions from resource
Failed to load FirebaseOptions from resource. Check that you have defined values.xml correctly.
On Android, Firebase reads its settings from a values.xml file that the Google services Gradle plugin builds from google-services.json.
4 causes, each with a fixMobile apps
FirebaseMessaging.getAPNSToken() returns null on iOS
FirebaseMessaging.instance.getAPNSToken() returns null
getAPNSToken() gives null when iOS has not handed the app an APNs token yet or never will.
4 causes, each with a fixMobile apps
Xcode cannot find GoogleService-Info.plist for the Runner target
error: Build input file cannot be found: '/Users/GoogleService-Info.plist' (in target 'Runner' from project 'Runner')
Xcode's project file lists GoogleService-Info.plist as an input, but nothing exists at the path it records.
3 causes, each with a fixMobile apps
Flutter: Firebase.initializeApp fails with Unable to establish connection on channel
Unable to establish connection on channel
The Dart side of firebase_core could not reach its native half.
4 causes, each with a fix