Zum Inhalt springen

Bug Report Beispiele: gut vs. schlecht im Vergleich

Vier realistische Bug Report Beispiele, jeweils als schwacher Report und starke Neufassung, mit Hinweisen, was einen Bug Report umsetzbar macht.

Ein gutes Bug Report Beispiel hat jedes Mal dieselben Teile: einen konkreten Titel, die Umgebung, nummerierte Schritte zum Reproduzieren ab einem bekannten Ausgangspunkt, erwartetes und tatsächliches Ergebnis mit dem genauen Fehlertext, wie oft es passiert, und Belege. Unten findest du vier realistische Bugs, jeder zweimal geschrieben: zuerst so, wie Bugs oft gemeldet werden, dann als Neufassung, mit der ein Entwickler arbeiten kann, ohne eine einzige Rückfrage zu stellen.

Die Beispiele decken die häufigsten Arten von Bugs ab: ein Ablauf, der stillschweigend scheitert, ein Layoutproblem auf einem Gerät, falsche Daten und ein sporadischer Fehler. Willst du das Format als leere Version, kopier unsere Bug Report Vorlage. Warum es die einzelnen Felder gibt, erklärt So schreibst du einen Bug Report.

Beispiel 1: Ein Ablauf, der stillschweigend scheitert

Ein Nutzer setzt sein Passwort zurück, aber die E-Mail kommt nie an.

Die schwache Version

Titel: Passwort-Reset kaputt

Passwort zurücksetzen funktioniert nicht. Mehrmals probiert. Bitte schnellstmöglich fixen.

Dieser Report gibt dem Entwickler fast nichts. Welcher Account? Welche Umgebung? Hat das Formular einen Fehler gezeigt oder Erfolg gemeldet? „Mehrmals probiert“ deutet etwas an, aber nicht, was. Und „schnellstmöglich“ ohne Angabe der Auswirkungen hilft niemandem beim Priorisieren.

Die starke Version

Titel: Keine Passwort-Reset-Mail für Accounts, die mit Google-Anmeldung erstellt wurden

Umgebung
- URL: https://app.example.com/forgot-password
- Chrome 154, macOS 26
- Account: [email protected] (erstellt über „Weiter mit Google“)
- Zeitpunkt: 2026-11-10 09:12 UTC

Schritte zum Reproduzieren
1. Abgemeldet /forgot-password aufrufen.
2. [email protected] eingeben und auf „Link zum Zurücksetzen senden“ klicken.

Erwartetes Ergebnis
Innerhalb weniger Minuten kommt eine Reset-Mail an.

Tatsächliches Ergebnis
Die Seite zeigt „Schau in dein Postfach“. Es kommt keine Mail an (30 Minuten
gewartet, Spam geprüft). Netzwerk: POST /api/auth/reset lieferte 200 mit Body
{"sent": false, "reason": "no_password_identity"}.

Häufigkeit
Immer bei Accounts, die über Google erstellt wurden (3/3). Funktioniert bei einem
Account mit E-Mail und Passwort ([email protected]).

Schweregrad
Schwer: Nutzer, die sich mit Google registriert haben, können kein Passwort setzen.

Warum das funktioniert

Die meldende Person hat zwei Arten von Accounts verglichen und das Muster gefunden: Betroffen sind nur Accounts, die mit Google-Anmeldung erstellt wurden. Dieser eine Vergleich grenzt die Ursache von „E-Mail ist kaputt“ auf einen bestimmten Zweig im Code ein. Außerdem hat sie das Network-Panel geöffnet und den Response-Body kopiert. Er zeigt, dass der Server weiß, dass er nichts gesendet hat, während die Seite Erfolg meldet. Dieser Widerspruch ist ein zweiter Bug, den man festhalten sollte. Der genaue Zeitpunkt erlaubt dem Team, die Logs des E-Mail-Anbieters zu prüfen. Hast du dir noch nie Netzwerk-Requests angesehen, zeigt unsere Anleitung Netzwerkverkehr in Chrome aufzeichnen, wie das geht.

Beispiel 2: Ein Layout-Bug auf einem Gerät

Auf einem kleinen Smartphone-Bildschirm verdeckt ein Banner den Button, den Nutzer drücken müssen.

Die schwache Version

Titel: Speichern geht nicht auf dem Handy

Der Speichern-Button funktioniert auf meinem Handy nicht.

„Funktioniert nicht“ kann heißen, dass der Button nichts tut, einen Fehler zeigt oder nicht erreichbar ist. „Mein Handy“ kann jedes von Tausenden Geräten und Browsern sein. Ein Entwickler, der auf einem großen Smartphone testet, sieht vermutlich kein Problem und schließt das Ticket.

Die starke Version

Titel: Cookie-Banner verdeckt auf kleinen Bildschirmen den Speichern-Button der Profilseite

Umgebung
- URL: https://app.example.com/settings/profile
- Safari auf iPhone SE (3. Generation), iOS 26, Hochformat
- Viewport etwa 375 x 667
- Nicht reproduzierbar auf iPhone 15 Pro oder Desktop

Schritte zum Reproduzieren
1. Die URL in einem privaten Tab öffnen (damit das Cookie-Banner erscheint).
2. Als [email protected] anmelden.
3. Ans Ende des Profilformulars scrollen.

Erwartetes Ergebnis
Der Speichern-Button ist oberhalb des Cookie-Banners sichtbar und antippbar.

Tatsächliches Ergebnis
Das Cookie-Banner (fixiert, etwa 180 px hoch) verdeckt den Speichern-Button.
Ein Tipp dorthin, wo der Button sein sollte, öffnet den Link „Einstellungen“
im Banner. Nach dem Schließen des Banners ist Speichern erreichbar.

Workaround
Zuerst das Cookie-Banner akzeptieren oder schließen.

Anhänge
- Screenshot: profile-save-hidden-iphone-se.png (Banner rot umrandet)

Warum das funktioniert

Layout-Bugs hängen von der Bildschirmgröße ab, also sind genaues Gerät, Ausrichtung und Viewport die entscheidenden Fakten. Die meldende Person hat außerdem auf anderen Geräten getestet und notiert, wo es nicht passiert. Das sagt dem Entwickler, dass er sich die Styles für kleine Bildschirme ansehen sollte. Der Schritt mit dem privaten Tab sorgt dafür, dass das Banner erscheint und der Entwickler denselben Bildschirm sieht. Der Workaround sagt dem Support, was er Nutzern heute antworten kann, und senkt die Dringlichkeit auf eine Weise, die das Team selbst beurteilen kann.

Beispiel 3: Falsche Daten

Die Summe im Dashboard passt nicht zu den exportierten Zahlen.

Die schwache Version

Titel: Zahlen sind falsch

Der Umsatz im Dashboard ist falsch. Der Export zeigt etwas anderes.
Keine Ahnung, was stimmt, aber eins davon ist kaputt.

Die meldende Person hat etwas Echtes bemerkt, aber „Zahlen sind falsch“ zwingt den Entwickler, selbst herauszufinden, welche Zahlen, für welchen Zeitraum und um wie viel. Daten-Bugs brauchen genaue Werte, denn die Größe der Abweichung ist oft der entscheidende Hinweis.

Die starke Version

Titel: Dashboard-Umsatz für Oktober liegt 1.240 $ unter dem CSV-Export

Umgebung
- URL: https://app.example.com/reports/revenue?period=2026-10
- Workspace: Acme Demo (ID 4821), Zeitzone America/Los_Angeles
- Chrome 154, Windows 11

Schritte zum Reproduzieren
1. Berichte öffnen, dann Umsatz.
2. Oktober 2026 auswählen.
3. Die Summe auf der Karte notieren.
4. Auf „CSV exportieren“ klicken und die Spalte Betrag summieren.

Erwartetes Ergebnis
Summe im Dashboard und Summe der CSV stimmen überein.

Tatsächliches Ergebnis
Dashboard: 48.310,00 $. Summe der CSV: 49.550,00 $. Differenz: 1.240,00 $.
Die Differenz entspricht den drei Bestellungen vom 31. Oktober nach 17:00 Uhr
Ortszeit Los Angeles (IDs 99812, 99815, 99820).

Häufigkeit
Immer für Oktober. Die Summen für September stimmen überein.

Notizen (Vermutung)
Sieht so aus, als gruppiere das Dashboard nach UTC-Datum und der Export
nach der Zeitzone des Workspace.

Warum das funktioniert

Der Report nennt beide Zahlen, die Differenz und die Bestellungen, aus denen die Differenz besteht. Dieser letzte Schritt hat die meldende Person ein paar Minuten gekostet und spart dem Entwickler deutlich mehr. Die Vermutung zu den Zeitzonen ist klar als Vermutung gekennzeichnet und von den Beobachtungen getrennt. Der Hinweis, dass der September stimmt, zeigt, dass der Bug an bestimmten Daten hängt und nicht am ganzen Bericht.

Beispiel 4: Ein sporadischer Fehler

Uploads schlagen manchmal fehl, und niemand kann sagen, warum.

Die schwache Version

Titel: Upload schlägt manchmal fehl

Manchmal schlagen Uploads mit einem Fehler fehl. Passiert zufällig.

„Zufällig“ heißt meistens „aus einem Grund, den noch niemand gefunden hat“. Ohne Fehlertext, Dateidetails oder eine Zählung gibt es nichts zu untersuchen.

Die starke Version

Titel: Upload von Dateien über 10 MB schlägt mit „Upload failed (413)“ fehl

Umgebung
- URL: https://app.example.com/projects/218/files
- Chrome 154 und Firefox 158, Windows 11, Büronetzwerk

Schritte zum Reproduzieren
1. Ein Projekt öffnen, dann den Tab Dateien.
2. Auf „Hochladen“ klicken und eine PDF über 10 MB wählen
   (getestet: 10,4 MB, 12 MB, 25 MB).

Erwartetes Ergebnis
Die Datei wird hochgeladen und erscheint in der Liste.

Tatsächliches Ergebnis
Der Fortschrittsbalken erreicht etwa 90 Prozent, dann „Upload failed (413)“.
Netzwerk: POST /api/files lieferte 413 Request Entity Too Large,
der Response-Body ist eine HTML-Fehlerseite, kein JSON.
Konsole: Uncaught (in promise) SyntaxError: Unexpected token '<'

Häufigkeit
Immer bei Dateien über 10 MB (6/6). Nie bei Dateien unter 9 MB (0/8).

Anhänge
- Bildschirmaufnahme eines fehlgeschlagenen Uploads (40 Sekunden)
- Bereinigte HAR-Datei eines Versuchs

Warum das funktioniert

Der „zufällige“ Bug hing in Wahrheit von der Dateigröße ab, und die meldende Person hat das mit Zählungen auf beiden Seiten der Grenze belegt. Der Status 413 und die HTML-Response deuten auf ein Größenlimit irgendwo vor der App hin, und der Konsolenfehler erklärt, warum der Nutzer eine allgemeine Meldung gesehen hat: Die App hat versucht, eine HTML-Seite als JSON zu lesen. Die HAR-Datei ist bereinigt, denn HAR-Dateien enthalten Cookies und Tokens; der HAR Sanitizer entfernt sie in deinem Browser.

Aus einem schwachen Report einen starken machen

Machst du die Triage für ein Support- oder QA-Team, bekommst du jede Menge Reports wie die schwachen Versionen oben. Sie selbst umzuschreiben geht schneller, als sie zurückzuschicken, solange du Antworten auf fünf Fragen bekommst:

  1. Was genau hast du gesehen? Bitte um den Fehlertext oder einen Screenshot, nicht um eine Beschreibung davon.
  2. Wo warst du? Die URL oder der Name des Bildschirms, dazu der Account.
  3. Was hast du direkt davor gemacht? Die letzten zwei oder drei Aktionen reichen meist, um mit dem Nachstellen anzufangen.
  4. Passiert es jedes Mal? Wenn nicht: ungefähr wie oft, und scheint irgendetwas es wahrscheinlicher zu machen?
  5. Was wolltest du erledigen? Daraus ergeben sich das erwartete Ergebnis und die echten Auswirkungen.

Stell alle fünf in einer Nachricht. Meldende, besonders Kunden, beantworten eine Runde Fragen bereitwillig; nach drei Runden geben sie auf. Hast du die Antworten, versuch den Bug selbst nachzustellen und ergänze, was du dabei lernst, so wie die Vergleiche in den Beispielen oben. Ein nachgestellter Bug mit deinen eigenen Belegen wandert viel schneller durch die Warteschlange als eine weitergeleitete E-Mail.

Was die guten Beispiele gemeinsam haben

  • Titel, die das Symptom und die Bedingung beschreiben, nicht nur die Funktion.
  • Ein bekannter Ausgangspunkt und die genauen verwendeten Daten.
  • Genaue Zahlen und Fehlertexte, nie „falsch“ oder „ein Fehler“.
  • Ein Vergleich: ein anderer Account, ein anderes Gerät, ein anderer Monat oder eine andere Dateigröße, wo es funktioniert.
  • Angehängte Belege, aus denen Geheimnisse entfernt wurden.
  • Vermutungen, die als Vermutungen gekennzeichnet sind.

Belege schneller erfassen

Die meisten starken Versionen oben brauchten die Konsole und das Network-Panel. Midge, eine kostenlose Chrome-Erweiterung, erfasst beides, während du deinen Bildschirm aufnimmst oder einen Screenshot machst. Jede Aufnahme enthält Konsolen-Logs, Netzwerk-Requests, Nutzeraktionen und Geräteinfos. Passwörter, Kartennummern, Tokens und Cookies werden in deinem Browser geschwärzt, bevor irgendetwas dein Gerät verlässt. Titel, Schritte und erwartetes Ergebnis schreibst du weiterhin selbst; die technischen Details kommen automatisch dazu.

Verwandte Anleitungen

Häufige Fragen

Wie sieht ein gutes Bug Report Beispiel aus?

Es hat einen konkreten Titel, die Umgebung, nummerierte Schritte ab einem bekannten Ausgangspunkt, erwartetes und tatsächliches Ergebnis mit dem genauen Fehlertext, wie oft es passiert, und Belege wie einen Screenshot, einen Konsolenfehler oder einen fehlgeschlagenen Request.

Was ist der häufigste Fehler in Bug Reports?

Fehlende oder vage Schritte zum Reproduzieren. Ohne sie muss der Entwickler raten, wie es zu dem Bug kam, und das endet oft mit einem Ticket, das als nicht reproduzierbar geschlossen wird.

Gehört ein Screenshot in einen Bug Report?

Ja, wenn das Problem sichtbar ist. Füg zusätzlich den Fehlertext hinzu, denn Text lässt sich durchsuchen und kopieren, und häng eine kurze Aufnahme an, wenn der Bug mehrere Schritte oder ein Timing betrifft.

Wo bekomme ich eine leere Version dieses Formats?

Nimm die Bug Report Vorlage zum Kopieren und Einfügen aus der Midge-Dokumentation. Sie hat dieselben Felder wie die guten Beispiele auf dieser Seite.