Was Ihre App sagen sollte, wenn etwas schiefgeht: Fehlermeldungen schreiben, die Menschen wirklich verstehen

Eine gute Fehlermeldung sagt, was passiert ist, wessen Schuld es ist, was als Nächstes zu tun ist – und löscht dabei nicht die Arbeit der Nutzer:innen. So wird aus einem Aussetzer ein neuer Versuch statt eines für immer verlorenen Nutzers.

Jede App bricht irgendwann ab. Das Internet fällt aus, ein Server stockt, jemand tippt eine Telefonnummer mit Buchstaben ein. Das lässt sich nicht vollständig verhindern. Was Sie wohl kontrollieren können, ist die Fehlermeldung – der Text, den Ihre App zeigt, wenn etwas schiefgeht. Und genau diese eine Meldung entscheidet oft darüber, ob jemand mit den Schultern zuckt und es noch einmal versucht, oder ob er still beschließt, dass Ihre App kaputt ist, und nie wiederkommt.

Genau diesen Moment vermasseln die meisten KI-gebauten Apps. Nicht, weil der Builder nachlässig gearbeitet hätte, sondern weil Fehlermeldungen der Teil sind, an den niemand denkt, bis vor einer echten Person etwas schiefläuft. Standardmäßig zeigen Apps meist eine von zwei denkbar schlechtesten Varianten: gar nichts, oder einen beängstigenden Block technischen Texts. Beheben wir beides.

Warum scheitern Apps lautlos oder zeigen erschreckende Fehlermeldungen?

Apps scheitern auf zwei schlechte Arten: Entweder sie sagen nichts, wenn etwas fehlschlägt, oder sie zeigen einen technischen Fehler, den ein normaler Mensch nicht lesen kann. Beides lässt die Nutzer:innen raten – und Raten ist es, was Menschen aufgeben lässt.

Das stille Versagen. Eine Freelancerin, die ich Maya nenne, baute ein Buchungsformular für ihr Fotografie-Business. Eine Kundin tippte auf „Buchung bestätigen”, der Button flackerte kurz – und dann nichts. Keine Bestätigung, kein Fehler, kein Ladesymbol. Hat es funktioniert? Die Kundin war sich nicht sicher, also buchte sie erneut. Jetzt hatte Maya zwei Buchungen für denselben Termin und eine verwirrte Kundin. Die App war nicht abgestürzt – das Speichern war nur fehlgeschlagen, und die App sagte nichts dazu, sodass die Person davor keine Ahnung hatte, was gerade Realität war.

Der erschreckende technische Fehler. Das andere Versagen ist lauter und irgendwie noch schlimmer. Eine Freiwillige, die für eine Community-Spendenaktion eine Tabelle hochladen wollte, bekam eine rote Box mit der Aufschrift Error 500: Internal Server Error. Sie las das als „Ich habe etwas kaputt gemacht.” Sie versuchte es nicht noch einmal, schrieb keine E-Mail um Hilfe – sie schloss einfach den Tab, weil die Meldung den Eindruck erweckte, das Problem läge bei ihr und es sei vielleicht unsicher, es noch einmal anzufassen.

Beide Nutzerinnen stießen auf ein normales, behebbares Problem. Beide gingen weg, weil die Fehlermeldungen der App entweder nichts sagten oder etwas Angsteinflößendes.

Was macht eine gute Fehlermeldung aus?

Eine gute Fehlermeldung tut vier kleine Dinge, in einfachen Worten: Sie sagt, was passiert ist, sagt, wessen Problem es ist, sagt, was als Nächstes zu tun ist, und verliert nicht die Arbeit der Nutzer:innen.

  1. Sagt, was passiert ist — „Wir konnten Ihre Buchung nicht speichern”, nicht Stille und nicht 500.
  2. Sagt, wessen Problem es ist — meist ist die ehrliche Antwort „unseres”, und das zu sagen beruhigt.
  3. Sagt, was als Nächstes zu tun ist — „Versuchen Sie es gleich noch einmal” oder „Prüfen Sie Ihre Internetverbindung und versuchen Sie es erneut.”
  4. Verliert nicht ihre Arbeit — was auch immer eingetippt wurde, steht noch im Formular, wenn die Meldung erscheint.

Das war’s. Kein Entschuldigungsessay, kein Fehlercode als Überschrift, keine Schuldzuweisung. Hier die gleichen drei Fehlschläge, neu geschrieben:

  • ❌ (nichts passiert) → ✅ „Das konnten wir gerade nicht speichern. Ihre Angaben sind noch hier – tippen Sie auf Bestätigen, um es erneut zu versuchen.”
  • ❌ Error 500: Internal Server Error → ✅ „Beim Hochladen der Datei ist bei uns etwas schiefgelaufen. Das liegt nicht an Ihnen. Versuchen Sie es in ein paar Minuten noch einmal.”
  • ❌ Invalid input → ✅ „Diese Telefonnummer sieht nicht richtig aus – sie sollte 10 Ziffern haben, etwa so: 555-123-4567.”

Beachten Sie, dass das letzte Beispiel auf das konkrete Feld zeigt und zeigt, wie es richtig aussieht. „Invalid input” lässt jemanden suchen; „diese Telefonnummer sollte 10 Ziffern haben” sagt genau, was zu ändern ist.

Welche App-Fehler sollten Sie zuerst beheben?

Sie brauchen keine eigene Meldung für jeden denkbaren Fehlschlag – drei Fälle decken fast alles ab, was in einer typischen App schiefgehen kann: das Speichern oder Absenden, das fehlschlägt, die Eingabe, die die App nicht verwenden kann, und das, was auf Ihrer Seite kaputtgeht.

Das Speichern oder Absenden, das fehlschlägt. Das vertrauenszerstörendste Problem, weil die Nutzer:innen alles richtig gemacht haben und nicht wissen, ob es funktioniert hat. Bestätigen Sie Erfolg immer aktiv und erklären Sie Fehlschläge. Lassen Sie sie nie raten, und werfen Sie nie weg, was sie eingegeben haben.

Das „Wir können das nicht verwenden, was Sie eingegeben haben” (Validierung). Das ist eigentlich kein Fehler – es ist ein Missverständnis. Fangen Sie es genau in dem Moment ab, in dem jemand das Feld verlässt, zeigen Sie auf das exakte Feld, und geben Sie ein Beispiel für das richtige Format. Warten Sie nicht, bis jemand auf Absenden klickt, um dann eine Wand aus Rot zu offenbaren.

Das „Etwas ist bei uns kaputtgegangen”. Echte Server- oder Netzwerkprobleme. Sagen Sie, dass es an Ihrer Seite liegt, bleiben Sie ruhig, und bieten Sie einen erneuten Versuch an. Die Nutzer:innen können Ihren Server nicht reparieren – geben Sie ihnen also nicht das Gefühl, sie müssten es.

Drei Gewohnheiten, die still helfen

Ein paar Dinge unterscheiden Apps, die mit Fehlschlägen souverän umgehen, von solchen, die es nicht tun:

  • Zeigen Sie nie einen rohen Fehlercode als gesamte Meldung. Ein Code kann klein darunter stehen, für den Support – aber die Überschrift, die ein Mensch liest, sollte ein Satz sein, kein ERR_CONN_RESET.
  • Geben Sie nie den Nutzer:innen die Schuld. „Sie haben etwas Falsches eingegeben” tut weh; „dieses Datum scheint in der Vergangenheit zu liegen – meinten Sie nächsten Monat?” hilft. Gleiche Information, komplett anderes Gefühl.
  • Behalten Sie immer die Eingaben. Wenn die App neu lädt oder das Speichern fehlschlägt und das Formular sich dabei leert, haben Sie aus einem kleinen Aussetzer zehn Minuten erneutes Eintippen gemacht. Menschen verzeihen ein fehlgeschlagenes Speichern. Sie verzeihen nicht, die Arbeit zweimal machen zu müssen.

Wie bringen Sie Ihren KI-Builder dazu, bessere Fehlermeldungen zu schreiben?

Das meiste davon lässt sich mit einer einzigen Anfrage erreichen – fügen Sie etwa den Prompt unten ein, und Ihr KI-Builder wendet die oben genannten Regeln für einfache Sprache auf Ihre gesamte App an.

„Wenn ein Speichern oder Hochladen fehlschlägt, scheitere nicht lautlos und zeige keinen technischen Fehlercode. Zeige eine kurze, freundliche Meldung in einfacher Sprache, die sagt, was passiert ist, sagt, dass ein erneuter Versuch in Ordnung ist, und alles behält, was die Nutzer:innen bereits eingegeben haben. Validiere Formularfelder, sobald jemand das Feld verlässt, und zeige eine konkrete Meldung mit einem Beispiel für das richtige Format.”

Bitten Sie ihn dann, Ihnen zu zeigen, was in drei Fällen passiert: das Internet ist aus, ein Pflichtfeld ist leer, und der Server ist langsam. Wenn die Antwort auf eines davon „es zeigt nichts” oder „es zeigt den rohen Fehler” lautet, ist das Ihre nächste Baustelle.

Wie testen Sie die Fehlermeldungen Ihrer App?

Schalten Sie Ihr WLAN aus, öffnen Sie Ihre App, und versuchen Sie, die Hauptfunktion auszuführen – das ist der ganze Test, und er dauert zwei Minuten.

Buchen Sie den Termin, speichern Sie die Notiz, laden Sie die Datei hoch. Schauen Sie, was passiert. Hat es Ihnen etwas gesagt, das ein normaler Mensch verstehen würde? Ist verloren gegangen, was Sie eingegeben hatten? Schalten Sie das WLAN wieder ein und tippen Sie absichtlich Unsinn in ein Feld. Gleiche Fragen.

Die meisten Apps bestehen diesen Test beim ersten Mal nicht, und das ist völlig in Ordnung – es zeigt Ihnen nur genau, wo Sie anfangen sollten. Sie müssen nicht jede Fehlermeldung perfekt machen. Finden Sie die eine Sache in Ihrer App, die am häufigsten kaputtgeht, und machen Sie diese Meldung zuerst freundlich, klar und ehrlich. Wenn eine echte Person das nächste Mal darauf stößt, wird sie es noch einmal versuchen, statt zu gehen – und genau darum geht es.