So schreiben Sie eine gute Fehlermeldung, mit Vorlage
Mit einer guten Fehlermeldung kann ein Entwickler das Problem reproduzieren, ohne eine einzige Frage zu stellen. Dieser Leitfaden erklärt, was hineingehört, gibt Ihnen eine Vorlage zum Kopieren und zeigt die Fehler, die Bugs schwer behebbar machen.
Was macht eine Fehlermeldung gut?
Eine gute Fehlermeldung ist konkret, reproduzierbar und vollständig. Sie beschreibt ein Problem, erklärt, wie es ausgelöst wird, sagt, was stattdessen erwartet wurde, und nennt die Umgebung, in der es aufgetreten ist. Ein Entwickler, der sie liest, kann die Seite öffnen und den Fehler innerhalb einer Minute sehen.
Die acht Bestandteile einer guten Fehlermeldung
- Titel. Eine kurze Zusammenfassung, was wo falsch ist. „Checkout - Bezahlen-Button reagiert auf dem Smartphone nicht“ ist besser als „Fehler im Checkout“.
- Seitenadresse. Die genaue URL, unter der das Problem auftritt.
- Schritte zur Reproduktion. Nummerierte Schritte ab einem bekannten Ausgangspunkt.
- Erwartetes Ergebnis. Was hätte passieren sollen.
- Tatsächliches Ergebnis. Was stattdessen passiert ist, mit der genauen Fehlermeldung, falls es eine gibt.
- Umgebung. Browser und Version, Betriebssystem, Gerät, Bildschirm- oder Fenstergröße, angemeldet oder nicht, und die Benutzerrolle.
- Nachweis. Ein Screenshot mit markiertem Problem oder eine kurze Bildschirmaufnahme bei Problemen mit dem Verhalten.
- Technische Details. Konsolenfehler und fehlgeschlagene Netzwerkanfragen, sofern Sie sie erhalten können.
Fügen Sie eine Priorität hinzu, wenn Ihr Team eine verwendet, zum Beispiel kritisch (blockiert eine Hauptfunktion, keine Umgehung), hoch, normal oder niedrig.
Vorlage für Fehlermeldungen
Kopieren Sie diese Vorlage in Ihren Issue-Tracker, Ihre E-Mail oder Ihren Chat.
Title: [Area] - [what is wrong]
Page: https://
Steps to reproduce:
1.
2.
3.
Expected result:
Actual result:
Environment: [browser + version], [operating system], [device], [window size]
Logged in as: [role or "not logged in"]
Evidence: [screenshot / recording]
Console errors / failed requests: [if available]
Priority: [critical / high / normal / low]
Beispiel
Title: Product page - price shows "12.9" without the euro sign
Page: https://shop.example/coffee/autumn-roast
Steps to reproduce:
1. Open the product page
2. Choose the 250 g variant
Expected result: the price shows "€12.90"
Actual result: the price shows "12.9"
Environment: Chrome 131, macOS 15, 1440 x 900 window
Logged in as: not logged in
Evidence: screenshot attached
Console errors: none
Priority: high (visible to every customer)
Häufige Fehler
- Mehrere Probleme in einer Meldung. Sie werden zu unterschiedlichen Zeiten behoben, getestet und geschlossen; melden Sie sie getrennt.
- Keine Schritte. „Es funktioniert nicht“ lässt sich nicht reproduzieren. Beginnen Sie auf einer bekannten Seite und führen Sie jeden Klick auf.
- Fehlende Umgebung. Viele Layoutfehler treten nur bei einer bestimmten Fenstergröße oder in einem bestimmten Browser auf.
- Screenshots ohne Kontext. Markieren Sie das Problem und zeigen Sie die Adressleiste oder nennen Sie die Seitenadresse.
- Meinungen als Tatsachen. „Das Blau ist hässlich“ ist eine Änderungsanfrage, kein Fehler. Sagen Sie, was Sie sich stattdessen wünschen.
Die Details von einem Tool erfassen lassen
Umgebung und Konsolenfehler von Hand zu sammeln ist mühsam und wird leicht vergessen. Ein Tool für visuelle Fehlermeldungen erfasst sie automatisch. Bei mumus klickt die meldende Person auf das fehlerhafte Element und schreibt Titel, Schritte und erwartetes Ergebnis; Screenshot, Seitenadresse, Browser, Fenstergröße, Konsolenfehler und fehlgeschlagene Anfragen werden automatisch hinzugefügt.
Häufige Fragen
Was sollte eine Fehlermeldung enthalten?
Einen klaren Titel, die Seitenadresse, nummerierte Schritte zur Reproduktion, das erwartete und das tatsächliche Ergebnis, die Umgebung (Browser, Betriebssystem, Gerät, Fenstergröße, Benutzerrolle), einen Screenshot oder eine Aufnahme sowie Konsolenfehler oder fehlgeschlagene Netzwerkanfragen, sofern verfügbar.
Wie schreibt man Schritte zur Reproduktion eines Fehlers?
Beginnen Sie in einem bekannten Zustand, etwa einer Seitenadresse und ob Sie angemeldet sind, und führen Sie dann jede Aktion als nummerierten Schritt auf, bis das Problem auftritt. Testen Sie die Schritte einmal selbst, bevor Sie die Meldung senden.