Google Sign-In-Fehler 10 im geschlossenen Test beheben

Dieser Leitfaden behandelt genau einen Fehler: die native Google-Anmeldung, die in der von Google Play ausgelieferten Version nicht funktioniert. Er grenzt ihn von ähnlich aussehenden Fehlern ab und behandelt dann Frameworks, andere Anmeldeanbieter und das, was Tester melden sollten. Jede hier zitierte Google-Seite wurde am 16. Oktober 2026 geprüft, und Berichte aus der Community sind als solche gekennzeichnet. Die Quellen stehen am Ende.

Google Sign-In im Play-Build beheben

Bringen Sie die App, die Ihre Tester installiert haben, mit dem dafür registrierten Paketnamen und Signatur-SHA-1 in Übereinstimmung. Gehen Sie diese Schritte der Reihe nach durch; die Wege über Firebase und Google Cloud folgen danach.

Play-Zertifikat in Firebase hinzufügen

Wählen Sie die passende Android-App aus, bevor Sie ihren Play-Signaturfingerabdruck hinzufügen. Die Schritte folgen der Firebase-Hilfe zu Fingerabdrücken und dem Firebase-Leitfaden zur Google-Anmeldung.

1. Öffnen Sie in der Firebase-Konsole das Projekt, das Ihre App verwendet, dann Project settings > General (Projekteinstellungen > Allgemein).
2. Wählen Sie unter Your apps (Meine Apps) die Android-App aus, deren Paketname zum fehlerhaften Build passt.
3. Klicken Sie auf Add fingerprint (Fingerabdruck hinzufügen), fügen Sie den SHA-1 der Play App Signing ein und speichern Sie. Fügen Sie ihn neben den vorhandenen Fingerabdrücken hinzu, statt diese zu ersetzen.
4. Bestätigen Sie unter Authentication > Sign-in method, dass Google aktiviert ist.
5. Wenn Firebase Sie auffordert, eine aktualisierte google-services.json herunterzuladen, ersetzen Sie die Datei in Ihrem Projekt. Laut Firebase “enthält [die Datei] die OAuth-Client-Informationen, die für die Google-Anmeldung erforderlich sind”, eine geänderte Datei bedeutet also einen neuen Build. Prüfen Sie, ob Projekt und Paket darin zur fehlerhaften App passen.

Fügen Sie einen SHA-256 nur dort hinzu, wo ein bestimmter Firebase-Dienst danach fragt. Die Telefonauthentifizierung zum Beispiel nutzt SHA-256 für ihren Play Integrity-Weg; Google Sign-In selbst stützt sich auf den SHA-1.

Google Cloud ohne Firebase konfigurieren

Zwei OAuth-Clients erledigen zwei verschiedene Aufgaben. Der Android-Client registriert Ihre App; die Web-Client-ID ist die, die Ihre Token-Anfrage verwendet.

1. Wählen Sie das Projekt aus, das Ihre Client-IDs ausgestellt hat, und öffnen Sie dann Google Auth platform > Clients (Google Cloud-Hilfe).
2. Suchen Sie nach einem vorhandenen Android-Client mit diesem Paketnamen und SHA-1, bevor Sie einen weiteren anlegen.
3. Falls er fehlt, wählen Sie Create Client, setzen Application type auf Android, geben einen Namen, den Paketnamen und den SHA-1 der Play App Signing ein und klicken dann auf Create. Das Android-Formular hat ein SHA-1-Feld; ein SHA-256 gehört dort nicht hinein.
4. Registrieren Sie jedes Paar aus Paket und Zertifikat, das Sie brauchen, zum Beispiel für Debug, lokalen Release und Play.
5. Lassen Sie den Web-Client für die Token-Anfrage bestehen, und legen Sie niemals einen Client-Secret in die App.

Die Reparatur nachweisen

Eine erfolgreiche Anmeldung beweist nicht, dass der Release repariert ist. Diese Checkliste ist unser empfohlener Abnahmetest, keine Google-Regel; die letzte Zeile ist wichtig, weil bei einem Entwickler die Anmeldung einmal funktionierte und bei der nächsten Anmeldung trotzdem scheiterte, ein Sitzungsproblem, das eine einzelne Prüfung übersehen würde.

Warum funktioniert die Anmeldung im Debug-Build, aber nicht im geschlossenen Test?

Die über Google Play installierte App kann eine andere Signatur haben als das APK, das Sie lokal installieren. Googles Leitfaden zur Client-Authentifizierung hält fest: “Android Studio signiert Ihre App automatisch mit einem Debug-Zertifikat.” Ein Release, den Sie selbst bauen, verwendet den Schlüssel, mit dem diese Variante konfiguriert ist. Mit Play App Signing signiert Ihr Uploadschlüssel das Bundle, das Sie hochladen, und Google signiert die APKs, die Ihre Tester erhalten, mit dem App-Signaturschlüssel.

Diese Schlüssel haben unterschiedliche Rollen, sind aber nicht immer unterschiedliche Werte: Sie können Ihren eigenen Signaturschlüssel bereitstellen, und manche Setups verwenden einen Schlüssel für zwei Rollen. Vergleichen Sie die tatsächlichen Fingerabdrücke statt der Schlüsselbezeichnungen.

Die Fingerabdrücke selbst auslesen

Für Builds auf Ihrem Rechner gibt der Gradle-Signaturbericht den SHA-1 und SHA-256 jeder Variante aus, und keytool liest den Debug-Keystore direkt aus (geben Sie das Keystore-Passwort ein, wenn Sie danach gefragt werden):

./gradlew signingReport

keytool -list -v -alias androiddebugkey -keystore ~/.android/debug.keystore

Ein lokaler Signaturbericht sagt Ihnen nicht, womit die Play-Version signiert wurde. Um den fehlerhaften Build selbst zu prüfen, installieren Sie ihn aus dem geschlossenen Test auf einem Gerät, ziehen ihn mit adb herunter und geben seine Zertifikate mit apksigner aus, das laut Google-Dokumentation “Informationen über die Signaturzertifikate des APK” anzeigt. Ersetzen Sie den Paketnamen und verwenden Sie den Pfad, den der erste Befehl ausgibt:

adb shell pm path com.example.app
adb pull /data/app/.../base.apk failing-play.apk
apksigner verify --print-certs failing-play.apk

Ich habe den SHA-1 hinzugefügt und es scheitert weiterhin

Vergleichen Sie das Zertifikat des fehlerhaften APK, seine endgültige Anwendungs-ID und die Client-IDs, bevor Sie weitere Einstellungen ändern. Arbeiten Sie diese Leiter von oben nach unten ab; jede Zeile schließt eine Ebene aus.

Zeile 4 ist nicht theoretisch. In einem im September 2026 berichteten Expo-Fall änderte das Hinzufügen von Fingerabdrücken nichts; die Lösung war ein Tippfehler in der Client-ID, die das Backend akzeptierte.

Mehrere Signaturzertifikate oder aktualisierte Schlüssel

Eine einzelne App kann mehr als eine registrierte Signaturidentität benötigen. Googles aktuelle Hilfe zu Play App Signing beschreibt eine hybride Signatur mit drei App-Signaturschlüsseln und fordert Sie auf, die Fingerabdrücke jedes einzelnen zu registrieren, und eine App, deren Signaturschlüssel aktualisiert wurde, kann weiterhin Installationen haben, die mit einem älteren signiert sind. Registrieren Sie die Identitäten, die Ihre Installationen tatsächlich tragen, und löschen Sie keine älteren Einträge, die noch funktionieren. Schlüsselrotation ist nicht Thema dieses Leitfadens, und sie ist keine Lösung für die Anmeldung.

Ein anderes Projekt besitzt dieses Paket und diesen SHA-1 bereits

Laut Firebase-Hilfe zu Konflikten “muss [ein Paar aus Paketname und SHA-1] in allen Firebase- und Google Cloud-Projekten eindeutig sein.” Wenn die Konsole Ihren Fingerabdruck ablehnt, weil ein anderes Projekt ihn hält, finden Sie heraus, welchem Projekt dieser OAuth-Client gehört, bevor Sie etwas löschen. Der Google-Support kann helfen, den Konflikt zu finden; entfernen Sie keine aktiven Clients oder Projekte, um sich durchzuraten.

Ist Fehler 10 dasselbe wie 12500, 12501 oder canceled?

Nein. Lesen Sie den genauen Fehler und die Bibliothek, die ihn erzeugt hat, bevor Sie jede gescheiterte Anmeldung als dasselbe Problem behandeln. Googles Referenz der allgemeinen Statuscodes definiert DEVELOPER_ERROR = 10 als “Die Anwendung ist falsch konfiguriert.” Die anderen Codes unten stammen aus Googles historischem SDK play-services-auth 21.6.0.

Altes Google Sign-In und Credential Manager

Googles Versionshinweise zu den Play-Diensten führen die Einstellung (Deprecation) der Google Sign-In-APIs in play-services-base am 16. April 2024 auf, und Google kündigte den Wechsel zu Credential Manager am 11. September 2024 an. Danach wurden die APIs am 26. August 2026 aus play-services-auth 22.0.0 und am 17. September 2026 aus play-services-base 18.11.0 entfernt, mit dem Hinweis “Removed the APIs related to Google Sign-in.” (die APIs für Google Sign-In wurden entfernt). Das ist eine Änderung am SDK; ein Abschaltdatum für bereits installierte Apps ergibt sich daraus nicht. Neuer Code und Upgrades sollten Googles Migrationsleitfaden folgen.

Die beiden APIs scheitern unterschiedlich. Credential Manager hat keinen Fehler 10; sein Leitfaden zur Fehlerbehebung warnt: “Eine hohe Anzahl von "Abbrüchen" kann tatsächlich auf eine Fehlkonfiguration hindeuten.” Ein Abbruch kann also ein Konfigurationsfehler oder ein echter Abbruch sein, und NoCredentialException ist wieder ein anderes Signal.

Prüfungen für Flutter, React Native, Expo und Unity

Die oben beschriebenen Prüfungen der nativen Identität gelten für jedes Framework, aber Setup, Initialisierung und Build-Konfiguration unterscheiden sich. Nutzen Sie den Weg für Ihr Framework und die Bibliotheksversion, die Ihre App tatsächlich auflöst.

Für React Native stellen die Maintainer der Bibliothek eine Konfigurationsprüfung bereit, die Sie im Stammverzeichnis des Projekts ausführen können:

npx @react-native-google-signin/config-doctor

Was ändert sich bei Supabase, Facebook, Apple oder Auth0?

Der Anbieter und der Anmeldeablauf bestimmen, welches Zertifikat, welche Client-ID oder welcher Callback übereinstimmen muss. Ein Google-SHA-1 ist die Antwort für die native Google-Anmeldung; bei anderen Anbietern kann er der falsche Hash sein, das falsche Format haben oder keine Rolle spielen.

Was sollten Tester an den Entwickler senden?

Ein nützlicher Bericht benennt den fehlerhaften Play-Build und die genaue Stelle, an der die Anmeldung abbricht. Ein Tester kann eine OAuth-Registrierung nicht durch erneutes Versuchen reparieren, seine Aufgabe sind also Belege, nicht Ausdauer. Kopieren Sie diese Vorlage und senden Sie sie an Ihre Tester:

App und Play-Testlink:
Installierte App-Version oder Build:
Installiert über: geschlossener Test bei Play / anderer Weg
Gerät und Android-Version:
Datum, Uhrzeit und Zeitzone:
Genauer Fehlertext oder ein geschwärzter Screenshot:
Wo es abbrach: vor der Kontoauswahl / nach der Wahl eines Kontos / nach der Rückkehr zur App
Ließ sich die App mit einer anderen Anmeldemethode öffnen?
Ergebnis des erneuten Tests und Version:

Bitten Sie die Tester, während der Korrektur für den Test angemeldet zu bleiben. Fragen Sie niemals nach Passwörtern, OAuth-Tokens, privaten Schlüsseln oder Zugriff auf die Play Console. Bitten Sie nach Ihrer Änderung denselben Tester, eine Funktion zu öffnen, die eine Anmeldung erfordert, sich dann ab- und wieder anzumelden und die Version und das Ergebnis festzuhalten.

Beeinflusst Fehler 10 meinen geschlossenen Test oder den Produktionszugriff?

Ein Konfigurationsfehler bei der Anmeldung ist etwas anderes als die Testteilnahme. Fehler 10 ist kein Ablehnungscode der Play-Richtlinien, und keine Google-Regel, die wir gefunden haben, besagt, dass er den Anmeldezeitraum Ihrer Tester zurücksetzt. Googles Seite zu den Testanforderungen ermutigt Sie, die App während des geschlossenen Tests zu verbessern. Halten Sie Ihre Tester also angemeldet und liefern Sie die Korrektur über denselben geschlossenen Track aus. Das ist eine Auslegung der veröffentlichten Regeln, kein Versprechen für jeden Einzelfall.

Eine kaputte Anmeldung ist trotzdem wichtig. Die Richtlinie zur Funktionalität von Google Play besagt: “Apps, die abstürzen, das Schließen erzwingen, einfrieren oder anderweitig nicht ordnungsgemäß funktionieren, sind nicht zulässig”, und eine Anmeldesperre hindert Tester daran, die Funktionen zu erreichen, die sie testen sollen. Beheben Sie den Fehler, bevor Sie den Produktionszugriff beantragen, und geben Sie den Prüfern funktionierende Anmeldedaten. Wenn bereits ein Prüfergebnis vorliegt, lesen Sie zur Ablehnung wegen fehlerhafter Funktionalität (Broken Functionality).

Zur Einordnung: Private Entwicklerkonten, die nach dem 13. November 2023 erstellt wurden, brauchen mindestens 12 Tester, die über die letzten 14 Tage fortlaufend angemeldet waren, bevor sie für diese App den Produktionszugriff beantragen. Nach dem Antrag sagt Google: “Dies dauert in der Regel bis zu sieben Tage, manchmal aber auch länger.” Wenn Tester in der Zählung fehlen, prüfen Sie, wie sie eingeladen wurden, bevor Sie die Anmeldung anfassen.

Häufig gestellte Fragen

Das Fazit

Menübezeichnungen in der Play Console und in Firebase sind die Fakten auf dieser Seite, die sich am schnellsten ändern. Wenn ein oben genannter Weg nicht mehr zu Ihrer Konsole passt, suchen Sie Play App Signing unter Protected with Play und die Fingerabdrücke unter Ihrer Android-App in den Firebase-Projekteinstellungen.