Wie man einen Bug Report schreibt (+ kostenlose Vorlage zum Download)
Zu wissen, wie man einen effektiven Fehlerbericht erstellt, ist ein wesentlicher Teil der Arbeit als Softwaretester, um die Qualitätssicherung aufrechtzuerhalten. Daher verbringen wir viel Zeit damit, Fehler in unseren Bugtracking-Tools zu protokollieren. Einen Fehler zu finden, kann aufregend sein, besonders wenn es sich um ein interessantes Szenario handelt. Aber wie wir ihn melden, kann genauso wichtig sein wie die Auswirkung auf das System.
Ein schlecht formulierter Fehlerbericht kann zu viel Reibung zwischen Teammitgliedern führen, insbesondere zwischen Testern und Entwicklern. Dies kann die Behebung von Fehlern behindern und letztlich das Nutzererlebnis ruinieren.
In diesem Artikel teile ich wichtige Details, darunter, wie man:
Want more from The CTO Club?
Create a free account to finish this piece and join a community of CTOs and engineering leaders sharing real-world frameworks, tools, and insights for designing, deploying, and scaling AI-driven technology.
Have an account? Log In
- Fehlerberichte meistern: Erfahren Sie die Schlüsselelemente, die jeder effektive Fehlerbericht enthalten sollte, um die Kommunikation zu optimieren und Fehler schneller zu beheben.
- Teamharmonie stärken: Entdecken Sie, wie gut geschriebene Fehlerberichte Reibung zwischen Testern und Entwicklern verhindern und so für reibungslosere Arbeitsabläufe sorgen.
- Kostenlose herunterladbare Vorlage: Laden Sie eine kostenlose Vorlage zum Bugtracking herunter, um Ihren effizienten Fehlerberichterstattungsprozess zu starten.
Wichtige Elemente eines Fehlerberichts
Unabhängig davon, welche Art von Anwendung Sie testen – ob Desktop-, Web-, Mobil-App oder ein API-Projekt –, gibt es einige Schlüsselelemente, die jeder gute Fehlerbericht enthalten sollte. Die meisten Bugtracking-Softwares bieten Felder für diese Elemente, darunter:
- ID: Wenn Sie ein Projektmanagement-Tool wie Jira verwenden, wird jeder neuen Fehlermeldung automatisch eine ID zugewiesen. Es gibt außerdem Testmanagement-Tools für Jira zum Fehlertracking.
- Titel/Beschreibung: Dies ist eine kurze Problembeschreibung. Sie sollte so knapp sein, dass sie leicht zu lesen ist, aber dennoch ausreichend beschreiben, um das Problem zu verstehen. Zum Beispiel: „Sortierung nach Preis funktioniert nicht, wenn ein Filter angewendet wurde.“
- Schritte zur Reproduktion: Fügen Sie hier möglichst viele relevante Details ein. Stellen Sie sicher, dass jeder, der versucht, das Problem nachzuvollziehen oder den Fix zu überprüfen, dies alleine anhand der genannten Schritte tun kann. Überspringen Sie keine Schritte, nur weil Sie annehmen, dass jeder einige Aktionen bereits kennt – alle benötigten Aktionen gehören in den Fehlerbericht.
- Erwartetes Ergebnis: Gehen Sie nicht davon aus, dass alle wissen, wie die Anwendung funktionieren sollte. Wenn beispielsweise eine Ausnahme im UI auftritt, wenn ein Button gedrückt wird, ist das nicht erwartet. Dennoch sollten Sie nicht nur schreiben „Keine Ausnahme wird ausgelöst“, sondern konkret beschreiben, welche Aktion der Button ausführen sollte, zum Beispiel: „Der Einstellungsdialog öffnet sich.“
- Tatsächliches Ergebnis: Dies erklärt sich von selbst – hier beschreiben Sie, was in der Anwendung passiert, nachdem alle Reproduktionsschritte durchgeführt wurden.
- Schweregrad: Dies gibt an, wie stark der Fehler sich auf das zu testende System (AUT) auswirkt.
- Priorität: Gibt an, wie schnell der Fehler behoben werden sollte. Eine höhere Priorität bedeutet, dass der Bug weiter oben im Backlog platziert wird und früher zu bearbeiten ist.
Weitere wichtige Informationen, die Sie einfügen sollten
Neben den oben genannten Elementen können weitere Informationen relevant sein, insbesondere bei der Eingabe in ein Fehlerbericht-Tool. Sie hängen vom Projekttyp, den Projektanforderungen oder auch vom Fehler selbst ab:
- Softwareversion: Die Build-Nummer, in der der Fehler gefunden wurde. Sie hilft dabei, Builds einzugrenzen, in denen der Fehler eingeführt wurde, und somit auch den verursachenden Code zu finden.
- Anhänge: Sie sind nicht immer erforderlich oder verfügbar, bringen aber oft großen Mehrwert. Fügen Sie nach Möglichkeit Screenshots oder Aufzeichnungen des gefundenen Problems, Logdateien, Stacktraces, Netzwerk-Requests und -Antworten usw. bei.
- Testdaten: Manche Fehler treten nur bei bestimmten Datensätzen auf. In diesem Fall sollten Sie diese Daten angeben – entweder direkt in den Schritten zur Reproduktion (z. B. „Anmeldung mit Nutzer [email protected]“) oder in einem spezifischen Feld im Fehler-Tracking-Tool.
- Umgebungsdetails: Wenn der Fehler etwa nur auf einem bestimmten Betriebssystem, Browser oder in einer Entwicklungsumgebung auftritt, sollten Sie dies angeben.
Tipps für einen guten Fehlerbericht
- Beschränke dich auf einen einzigen Fehler pro Meldung. Wenn du weitere Fehler im selben Bereich entdeckst, kannst du sie mit deinem Issue Tracker verlinken. Mehr als einen Defekt zu melden, kann zu Verwirrung führen und die Behebung verzögern.
- Prüfe in deinem Trackingsystem, ob der Fehler bereits gemeldet wurde. Falls er schon geöffnet ist, ergänze relevante Details, die im ursprünglichen Fehlerbericht noch nicht enthalten waren.
- Versuche, den Fehler mehrmals zu reproduzieren. Versuche, den kürzesten Weg zu finden, ihn zu reproduzieren (mit möglichst wenigen Schritten).
- Verirre dich nicht in irrelevanten Details. Der Fehlerbericht und die Schritte sollten leicht verständlich und nachvollziehbar sein.
- Stelle keine Vermutungen darüber an, warum der Fehler auftritt (es sei denn, du weißt zu 100 %, was ihn verursacht).
Fehlerbericht-Vorlage
Ich möchte dir nun einige Vorlagen für Fehlerberichte vorstellen. Du kannst sie kopieren oder an die Bedürfnisse deines Projekts anpassen.
Jira-Fehlerverfolgungsvorlage
Jira ist ein sehr weit verbreitetes Problemverfolgungstool von Atlassian. Wenn dein Team es nutzt, ist der Fehlertyp vermutlich bereits eingerichtet. Als Tester oder Manager eines Software-Entwicklungsteams kannst du einen Workflow zur Fehlerverfolgung für den Lebenszyklus von Fehlern erstellen (diese Funktion bietet viele Vorteile von Issue-Tracking-Software).
Du kannst in Jira außerdem benutzerdefinierte Felder hinzufügen, zum Beispiel für die Testumgebung oder ein eigenes Feld, in dem die getestete Funktionalität vermerkt wird. Oder du fügst eine Standardbeschreibung hinzu, die alle Informationen enthält, die jeder Fehlerbericht umfassen soll. Hier ist ein Beispiel, das ich erstellt habe:
Wenn ich nun einen neuen Fehler melden möchte, sind diese Informationen bereits vorausgefüllt. So sieht meine Fehlerbericht-Vorlage in Jira aus, mit benutzerdefinierten Feldern und einer Standardbeschreibung:
Sie enthält die wichtigsten Informationen, die laut unserer Definition ein Fehlerbericht haben sollte:
- Ein Titel („Beispielfehler“)
- In der Beschreibung: die Voraussetzungen, die Reproduktionsschritte sowie die erwarteten vs. tatsächlichen Ergebnisse
- Ein benutzerdefiniertes Feld für die Umgebung
- Eine Schwere- und eine Prioritätsstufe, auswählbar aus Dropdowns mit vordefinierten Werten
- Ich habe den Bearbeiter (Assignee) freigelassen. Je nach Projektkonventionen können neue Fehler automatisch einer bestimmten Person zugewiesen werden oder derjenige, der daran arbeitet, weist ihn sich selbst zu
- Ein Label – hilfreich, wenn du z. B. verfolgen möchtest, welche Funktionalität betroffen ist
- Ein Fälligkeitsdatum – wird vielleicht erst ergänzt, wenn das Backlog priorisiert ist
- Den Melder (in diesem Fall wird das automatisch mit dem Jira-Nutzer ausgefüllt, der den Fehler meldet)
Optional bietet Jira viele Integrationen, der Fehler kann mit Testfällen, Git-Branches oder sogar Pull Requests verknüpft werden.
Du kannst auch deren Fehlerverfolgungsvorlage als Projekt-Vorlage nutzen, falls du Jira nur zur Defektverfolgung benötigst und nicht agil arbeitest.
Excel-Fehlerbericht-Vorlage
Manche Teams nutzen Tabellen als ihr Fehlerverfolgungssystem. Ich finde sie nützlich für sehr kleine Projekte, bei denen die Einrichtung eines Issue-Tracking-Systems zu aufwendig wäre, oder um Fehler bei neuen Funktionen zu erfassen, die sich noch in der Entwicklung befinden.
Du kannst Google Sheets/Docs oder Microsoft Excel/Word einsetzen – eine Fehlerbericht-Vorlage könnte beispielsweise so aussehen:
Die Spalten spiegeln wider, welche Informationen der Bericht enthalten sollte:
- Die ID (Excel weiß, wie der Wert bei jedem Hinzufügen einer neuen Zeile automatisch erhöht wird)
- Ein Titel
- Die Schritte zur Reproduktion
- Erwartete und tatsächliche Ergebnisse
- Der Name des Meldenden
- Schweregrad und Fehler-Priorität – hier habe ich Dropdown-Menüs verwendet, weil die Werte vordefiniert sein sollten
- Umgebung
- Zusätzliche Informationen: Für alles, was sonst noch erwähnenswert ist und nicht in die anderen Spalten passt
Fazit
Das Schreiben eines guten Software-Fehlerberichts ist eine wichtige Fähigkeit für Softwaretester, daher solltest du besonders auf die oben erklärten bewährten Methoden achten. Du kannst dich auch auf die Beispiele der Bug-Tracker-Vorlagen verlassen, die ich bereitgestellt habe. Sie lassen sich an verschiedene von dir genutzte Tools wie Trello oder Asana anpassen.
Wenn dir dieser Inhalt gefallen hat, abonniere den The QA Lead Newsletter, um in Kontakt zu bleiben und aktuelle News und Trends im Software-Testprozess zu erhalten!
