Zum Inhalt springen

Bug Report schreiben, mit dem Entwickler arbeiten können

So schreibst du einen Bug Report, der behoben wird: konkreter Titel, genaue Repro-Schritte, erwartetes vs. tatsächliches Ergebnis, Umgebung und Belege.

Um einen Bug Report zu schreiben, mit dem Entwickler arbeiten können, stellst du das Problem zuerst nach. Dann schreibst du einen konkreten einzeiligen Titel, die Umgebung (URL, Browser und Version, Betriebssystem, Account), nummerierte Schritte zum Reproduzieren ab einem bekannten Ausgangspunkt, das erwartete Ergebnis und das tatsächliche Ergebnis mit den genauen Fehlermeldungen. Dazu hängst du Belege an, etwa einen Screenshot oder eine Aufnahme, die Konsolenfehler und den fehlgeschlagenen Netzwerk-Request. Ein Bug pro Report.

Der Test für einen guten Report ist einfach: Könnte ein Entwickler, der das Problem nie gesehen hat, es auf seinem eigenen Rechner auslösen, ohne dich irgendetwas zu fragen? Wenn ja, wird der Bug wahrscheinlich schnell behoben. Muss er mit Rückfragen zurückkommen, kostet jede Runde einen Tag. Wenn du die Felder als Checkliste willst, kopier unsere Bug Report Vorlage.

1. Stell den Bug nach, bevor du schreibst

Versuch, den Bug ein zweites Mal auszulösen. Achte dabei auf die Details, die eine Rolle spielen könnten:

  • Mit welchem Account oder welcher Rolle du unterwegs warst.
  • Welche Daten beteiligt waren: ein bestimmtes Produkt, ein langer Name, eine leere Liste, eine große Datei.
  • Welche Schritte wirklich nötig sind. Lass Schritte einzeln weg, um den kürzesten Weg zu finden.
  • Ob der Fehler auch in einem anderen Browser oder in einem privaten Fenster auftritt.

Tritt er jedes Mal auf, umso besser. Tritt er nur manchmal auf, zähl mit: „4 von 10 Versuchen“. Kannst du ihn gar nicht nachstellen, meld ihn trotzdem und sag das klar dazu.

2. Prüf, ob er schon gemeldet ist

Durchsuch den Tracker nach der Fehlermeldung, dem Namen der Seite und ein paar Stichwörtern. Findest du einen Treffer, ergänze dort deine Details, statt ein neues Ticket anzulegen: deine Umgebung, einen neuen Weg, den Fehler auszulösen, oder die Info, dass er im neuesten Build immer noch auftritt. Duplikate verteilen die Informationen über mehrere Tickets und verschwenden Zeit bei der Triage.

3. Schreib einen konkreten Titel

Oft ist der Titel das Einzige, was bei der Triage gelesen wird. Er sollte das Problem beschreiben, nicht die Funktion.

Schwacher TitelBesserer Titel
Login kaputtAnmeldung mit Google führt in Safari zurück auf die Login-Seite
Bug in BerichtenCSV-Export des Verkaufsberichts verliert Zeilen nach 1.000
Seite ist langsamAbrechnungsseite braucht bei Accounts mit vielen Rechnungen über 10 Sekunden zum Laden
Fehler beim SpeichernProfil mit Emoji im Namen speichern liefert „Invalid input“

Ein nützliches Muster: was kaputt ist, plus wann es passiert, plus wo.

4. Beschreib die Umgebung

Viele Bugs treten nur in einem bestimmten Setup auf. Gib Folgendes an:

  • URL der Seite, auf der es passiert ist.
  • Browser und Version, zum Beispiel Chrome, Firefox, Safari oder Edge mit der Versionsnummer aus der „Über“-Seite.
  • Betriebssystem und Gerät.
  • Bildschirmgröße, wenn es ein Layout-Problem ist.
  • App-Version oder Build, wenn die App eine anzeigt.
  • Account, Rolle oder Testnutzer und alles Besondere daran (ein Testaccount, eine große Organisation, eine Spracheinstellung, die nicht Englisch ist).
  • Zeitpunkt, mit Zeitzone, damit das Team ihn in den Server-Logs findet.

5. Schreib die Schritte zum Reproduzieren

Die Schritte sind das Herzstück des Reports. Gute Schritte:

  • Beginnen bei einem bekannten Zustand: „Als Admin angemeldet, im Dashboard“.
  • Enthalten eine Aktion pro nummeriertem Schritt.
  • Nennen die genauen Daten: das Produkt, die Datei, den getippten Text. Echte Passwörter oder Kartennummern gehören nie hinein; nimm Testdaten.
  • Verwenden die Beschriftungen aus der App, fett oder in Anführungszeichen, damit der Entwickler denselben Button findet.
  • Enden in dem Moment, in dem der Bug auftritt.
1. Als [email protected] anmelden (Rolle Admin).
2. Zu „Einstellungen“ gehen, dann „Team“.
3. Auf „Mitglied einladen“ klicken.
4. „[email protected]“ eingeben und die Rolle „Betrachter“ wählen.
5. Auf „Einladung senden“ klicken.

6. Schreib erwartetes und tatsächliches Ergebnis

Stell beide nebeneinander:

Erwartet: Die Einladung erscheint in der Liste „Ausstehend“, und eine Bestätigung wird eingeblendet.
Tatsächlich: Der Dialog schließt sich, keine Bestätigung erscheint, und die Liste „Ausstehend“ bleibt leer.
             Auch nach dem Neuladen fehlt die Einladung.

Beschreib, was du beobachtet hast, nicht, was du für die Ursache hältst. „Der Einladungs-Request ist fehlgeschlagen“ ist eine Schlussfolgerung; „der Dialog hat sich geschlossen, und in der Liste ist nichts aufgetaucht“ ist eine Beobachtung. Hast du eine Fehlermeldung gesehen, kopier sie wörtlich als Text. Entwickler suchen genau nach diesem String in ihrem Code.

7. Häng Belege an

Belege machen aus einer Beschreibung einen Beweis und zeigen oft direkt auf die Ursache.

  • Screenshot, auf dem die Problemstelle markiert ist. Schneid persönliche Daten weg, die nichts damit zu tun haben.
  • Bildschirmaufnahme für alles, was mit Bewegung, Timing oder mehreren Schritten zu tun hat. Halte sie kurz und starte kurz vor dem Problem.
  • Konsolenfehler. In Web-Apps ist ein roter Fehler in der Browserkonsole oft der nützlichste Hinweis. Siehe Konsolen-Logs in Chrome exportieren.
  • Der fehlgeschlagene Netzwerk-Request. URL, Statuscode und Response-Body des API-Aufrufs, der gescheitert ist. Siehe Netzwerkverkehr in Chrome aufzeichnen.
  • Eine HAR-Datei, wenn das Team die ganze Netzwerksitzung sehen will. Folge der Anleitung So bekommst du eine HAR-Datei und bereinige sie vorher mit dem HAR Sanitizer, denn HAR-Dateien enthalten Cookies und Tokens.

8. Bewerte die Auswirkung ehrlich

Sag, wie schlimm es ist und wie viele Leute betroffen sind. Nutz die Schweregrad-Skala deines Teams, falls es eine gibt. Bleib ehrlich: Wenn alles kritisch ist, ist nichts kritisch. Erwähne einen Workaround, falls du einen gefunden hast; er ändert, wie dringend der Fix ist, und hilft dem Support in der Zwischenzeit.

9. Bleib bei einem Bug

Hast du drei Probleme auf derselben Seite gefunden, schreib drei Reports. Dann kann jeder für sich zugewiesen, behoben, getestet und geschlossen werden. Verknüpf sie, wenn sie zusammenzuhängen scheinen.

10. Bleib erreichbar

Behalte das Ticket nach dem Absenden im Blick, falls Fragen kommen. Wenn der Fix live ist, teste mit denselben Schritten erneut und bestätige ihn. Taucht der Bug später wieder auf, öffne das ursprüngliche Ticket erneut oder verlinke darauf, damit die Historie an einem Ort bleibt.

Häufige Fehler

  • Vage Titel wie „geht nicht“ oder „Problem mit Seite“.
  • Fehlende Schritte oder Schritte, die mitten in einem Flow beginnen.
  • Screenshots von Fehlermeldungen statt des Textes, nach dem man nicht suchen kann.
  • Mehrere Bugs in einem Ticket.
  • Echte Geheimnisse im Report: Passwörter, API-Keys, Session-Cookies oder Kundendaten in Screenshots und Logs.
  • Emotionale Sprache. Ein ruhiger, sachlicher Report wird schneller behoben als ein wütender.

Gute und schlechte Reports im direkten Vergleich findest du in unseren Beispielen für Bug Reports.

Weniger schreiben, mehr erfassen

Der meiste Aufwand in einem Bug Report steckt in den technischen Details, und genau die vergessen Meldende am häufigsten. Midge, eine kostenlose Chrome-Erweiterung, nimmt deinen Bildschirm auf oder macht einen Screenshot und hängt diese Details für dich an, sodass du nur Titel, Schritte und dein erwartetes Ergebnis schreibst. 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. Der Report wird als ein einziger Link geteilt, den du in den Tracker einfügst, den dein Team nutzt.

Verwandte Anleitungen

Häufige Fragen

Was sind die wichtigsten Teile eines Bug Reports?

Schritte zum Reproduzieren, das erwartete Ergebnis und das tatsächliche Ergebnis. Mit diesen dreien kann ein Entwickler das Problem meist selbst sehen. Angaben zur Umgebung und Belege wie Screenshots und Konsolenfehler machen es schneller.

Wie lang sollte ein Bug Report sein?

So kurz wie möglich, solange er vollständig ist. Die meisten guten Reports passen auf einen Bildschirm: ein einzeiliger Titel, eine kurze Zusammenfassung, fünf bis zehn Schritte, erwartetes und tatsächliches Ergebnis und Anhänge.

Was, wenn ich den Bug nicht nachstellen kann?

Meld ihn trotzdem und sag das dazu. Beschreib genau, was du gerade getan hast, wann es passiert ist, und häng alle Belege an, die du hast, etwa einen Screenshot oder einen Konsolenfehler. Trag als Häufigkeit „einmal aufgetreten“ ein.

Sollte ich meine Vermutung zur Ursache angeben?

Halte Beobachtungen und Vermutungen auseinander. Schreib in die Hauptfelder, was du gesehen hast, und wenn du eine Theorie hast, ergänze sie in einem Notizabschnitt, klar als Vermutung gekennzeichnet.