AppReviewX Anmelden

Push-Benachrichtigungen kommen im Test-Build nicht an

Systematischer Check: Berechtigung, Token, Kanal, Akkuregeln und Server-Seite.

In diesem Ratgeber

Auf deinem Handy funktioniert der Push, beim Tester kommt nichts an? Dafür gibt es fünf typische Ursachen. Prüfe sie von innen nach außen: erst das Gerät, dann dein Server. Jede Ebene kostet ein paar Minuten, und die erste, die nicht stimmt, ist deine Antwort.

1. Berechtigung auf dem Gerät

  • Ab Android 13 (API 33) sind Benachrichtigungen eine Laufzeit-Berechtigung, die die App erfragen muss; auch auf iOS muss der Nutzer zustimmen (prüfe Apples aktuelle Dokumentation). Wer „Nicht erlauben“ getippt hat, bekommt nichts. Laut Android-Dokumentation wird ein Nutzer bei Apps mit Ziel-API 32 oder niedriger danach nicht erneut gefragt, bis die App neu installiert oder auf Ziel Android 13 oder höher aktualisiert wird.
  • Bitte den Tester, in den Systemeinstellungen zu deiner App nachzusehen, ob Benachrichtigungen aktiv sind.
  • Prüfe deinen eigenen Ablauf: Erscheint die Abfrage überhaupt, und an einer sinnvollen Stelle? Wenn nie eine Abfrage kommt, liegt der Fehler in der App, nicht im Handy.

2. Benachrichtigungskanal (Android)

  • Android sortiert Mitteilungen in Kanäle (ab Android 8.0 Pflicht; bei Apps mit Ziel-API 26 oder höher wird eine Mitteilung ohne Kanal nicht angezeigt). Ist ein Kanal ausgeschaltet oder stumm, kommt die Nachricht an, wird aber nicht angezeigt.
  • Der Tester schaut in den Benachrichtigungseinstellungen der App in die Kanalliste.
  • Sobald ein Kanal existiert, kann die App Wichtigkeit und Ton nicht mehr ändern; das steuert der Nutzer. Ein Handy mit älterem Kanal behält das alte Verhalten, auch wenn du den Code geändert hast. Androids Dokumentation empfiehlt für Testkanäle auf Entwicklungsgeräten, die App neu zu installieren oder ihre Daten zu löschen; auch eine neue Kanal-ID zeigt, ob das die Ursache ist.

3. Das Token

Der Push-Dienst adressiert ein Gerät über ein Token. Ohne gültiges Token keine Zustellung.

  • Gib das Token auf dem Gerät aus und vergleiche es mit dem, das dein Server gespeichert hat. Sind sie gleich?
  • Tokens können sich ändern, etwa nach einer Neuinstallation oder einem Zurücksetzen der Daten. Schickt deine App das neue Token an den Server?
  • Prüfe, ob der Test-Build dasselbe Push-Projekt und dieselbe Konfiguration nutzt wie dein Server. Eine Build-Variante mit anderer Konfigurationsdatei ist ein häufiger Fehler.
  • Finde auf iOS in Apples aktueller Dokumentation zu Push-Benachrichtigungen heraus, welche Push-Umgebung (Entwicklung oder Produktion) dein Build nutzt, und stelle sicher, dass dein Server an dieselbe sendet.

4. Akku- und Hintergrundregeln

Manche Hersteller beenden oder verzögern Hintergrund-Apps sehr aggressiv. Dann kommt ein Push Minuten zu spät oder nur, wenn der Bildschirm an ist. Wenn die Zustellung unregelmäßig statt ganz weg ist, lies Hintergrundarbeit wird beendet: Akkuoptimierung und lass den Tester es mit einer Ausnahme von den Akkubeschränkungen testen.

5. Server-Seite

  • Sieh dir die Antwort deines Push-Aufrufs an. Ein Fehler wie „invalid token" oder „unregistered" heißt: Das Token ist veraltet.
  • Prüfe den Nachrichtentyp. Eine reine Datennachricht zeigt nichts an, solange deine App die Mitteilung nicht selbst baut. Eine Nachricht, die erscheinen soll, braucht die Anzeigefelder.
  • Prüfe Priorität und Lebensdauer. Eine kurze Lebensdauer heißt: Ein Handy, das offline war, verpasst die Nachricht. Laut Firebase-Dokumentation kann eine Nachricht ohne gesetzte Lebensdauer bis zu vier Wochen gültig sein; bei 0 Sekunden wird eine nicht sofort zustellbare Nachricht verworfen.
  • Sende eine Testnachricht an genau ein Token aus der Konsole deines Push-Anbieters. Kommt sie dort an, aber nicht von deinem Server, liegt der Fehler in deinem Servercode.

Schnell eingrenzen

Was du siehst Wahrscheinliche Ebene
Läuft bei dir, bei keinem Tester Server oder Build-Konfiguration
Nur ein Tester betroffen Berechtigung, Kanal oder Akku
Kommt spät oder nur bei Bildschirm an Akkuregeln
Server meldet ungültiges Token Token

Frag den Tester nach den richtigen Angaben

Handymodell, Android- oder iOS-Version, ob die Benachrichtigungen erlaubt sind, ob die App nach der Installation einmal geöffnet wurde und ob der Energiesparmodus läuft. Ein guter Fehlerbericht erspart eine Rückfrage-Runde.

Weiterlesen

Du brauchst echte Geräte, um den Fix zu bestätigen? Bei AppReviewX bekommst du privates, strukturiertes Feedback von anderen Entwicklern: Du schreibst ein Feedback, bekommst einen Credit, und Credits bezahlen Feedback zu deiner eigenen App. So funktioniert AppReviewX