Einen Bug zu beheben heißt, einen reproduzierbaren Defekt dazu zu bringen, nicht mehr zu reproduzieren — und den Beleg zu hinterlassen, dass er nicht zurückkommt. Die erste Hälfte ist „Code ändern". Die zweite Hälfte ist „sauber schließen" — und die meisten Teams machen nur die erste, weshalb dasselbe Problem drei Monate später durch eine andere Tür zurückkommt. Die Qualität einer Korrektur misst sich nicht daran, wie elegant die Änderung war. Sie misst sich daran, ob der nächste Regressionslauf, die nächste Person am Code und Sie selbst in drei Monaten allein anhand des Datensatzes erkennen können, dass der Fehler wirklich weg ist.
Dieser Artikel behandelt nur „wie beheben, wie verifizieren, wie schließen". Welcher Bug zuerst dran ist, gehört zur Triage — siehe Bug-Triage-Leitfaden. Wie man überhaupt einen behebbaren Bericht schreibt, steht in was ein Bugreport enthalten sollte.
Der Sechs-Schritte-Kreislauf
Jeder Schritt hat eine Mindestanforderung an Belege. Wer sie nicht erfüllt, geht einen Schritt zurück statt vorwärts — das ist die nützlichste Regel hier.
| Schritt |
Was Sie tun |
Mindestbeleg |
Wenn nicht erfüllt |
| 1 Lesen |
Entscheiden, ob der Bericht startbar ist |
Seiten-URL, Umgebung (Browser / OS / Version), erwartet vs. tatsächlich |
Zurückgeben statt raten |
| 2 Reproduzieren |
Den Fehler einmal selbst auslösen |
Eine bestätigte Reproduktion oder ein ausdrückliches „nicht reproduzierbar" |
Festhalten, was versucht wurde; parken, nie schließen |
| 3 Lokalisieren |
Finden, welche Schicht defekt ist |
Ein wörtlicher Fehler, eine fehlgeschlagene Anfrage oder ein Bisect-Ergebnis |
Änderungen stoppen; erst Beobachtbarkeit schaffen |
| 4 Beheben |
Ursache mit der kleinsten Änderung beseitigen |
Eine Änderung, eine Ursache |
Commit aufteilen |
| 5 Verifizieren |
Beweisen, dass es behoben ist und nichts anderes brach |
Derselbe Pfad erneut + Randfälle + Regressionsmatrix |
„Sieht gut aus" ist keine Verifikation |
| 6 Schließen |
Für die nächste Person lesbar machen |
Eine Zeile Ursache + ein Link zum Beleg |
„Behoben" allein ist kein Abschluss |
Schritt 1: Bericht lesen und entscheiden, ob man starten kann
Ein startbarer Bericht enthält drei Dinge: wo, in welcher Umgebung und wie das Tatsächliche vom Erwarteten abweicht. Fehlt eines, ist die richtige Aktion das Zurückgeben — nicht, den Code zu öffnen und sich umzusehen.
Die Kosten von „sich umsehen" werden stark unterschätzt. Ein erheblicher Teil der Seiten, die Entwicklung nach 40 Minuten Raten annimmt, ist nicht die Seite, die der Melder meinte. Eine Runde Zurückgeben kostet zwei Minuten.
Schritt 2: Reproduzieren oder klar sagen, dass es nicht geht
Reproduktion ist die Wasserscheide. Ein verlässlich reproduzierbarer Defekt ist nur eine Frage der Zeit. Ein nicht reproduzierbarer macht jede Änderung zum Glücksspiel.
Drei Dinge müssen dabei fixiert werden, sonst reproduzieren Sie nicht denselben Defekt:
Datenzustand. Welches Konto, sind Caches beteiligt, liegen alte Daten im localStorage.
Build-Version. Frontend-Bundle, Backend-Commit, aktive Feature-Flags.
Zeitverhalten. Wurde sofort nach dem Laden geklickt, nach ein paar Sekunden, nach einem Tab-Wechsel, bei langsamer Verbindung.
Wenn es wirklich nicht reproduziert: als „nicht reproduzierbar" festhalten, zusammen mit drei Fragen, statt zu schließen:
- Auf welcher Seite und über welchen Einstieg waren Sie? (Die Original-URL trägt oft Parameter.)
- Hängt es an einem bestimmten Konto, einer Rolle, einer Berechtigung?
- Zu welcher Uhrzeit ist es passiert? (Passt es zu einem Log-Eintrag oder Deploy, haben Sie eine Spur.)
Schritt 3: Lokalisieren — erst die Schicht bestimmen
Langsame Korrekturen sind selten schwere Probleme; es sind Probleme, die in der falschen Schicht gesucht werden. Drei Handgriffe reduzieren auf eine Schicht:
| Handgriff |
Was Sie ansehen |
Was es ausschließt |
| Konsole |
Wörtlicher Fehler und Stack |
Schließt „reine Styling- / reine Datenprobleme" aus |
| Netzwerk-Panel |
4xx / 5xx, und ob Request- und Response-Body passen |
Trennt „Frontend hat nie gesendet" von „Backend hat Falsches zurückgegeben" |
| Bisect / Rollback |
Welche Version oder welcher Commit zuletzt gut war |
Schließt „das war schon immer so" aus |
Fehlertexte lesen: Log-Level erklärt und Arten von Programmierfehlern. Konsole öffnen: Browser-Konsole öffnen. Für Nicht-Entwickler, die zuerst selbst schauen wollen: Browser-DevTools für Nicht-Entwickler.
Eine konkrete Reihenfolge: API liefert 500 → Backend. API liefert 200, aber ein Feld ist falsch → Vertrag. API wurde nie gesendet → Frontend-Logik oder Validierung. API in Ordnung, UI falsch → Rendering. Diese vier Zeilen decken den Großteil dessen ab, was Web-Teams trifft.
Schritt 4: Mit der kleinsten Änderung beheben
„Kleinste Änderung" ist keine Vorsicht, sondern Verifizierbarkeit. Ein Pull Request, der gleichzeitig den Bug behebt, ein Modul refaktoriert und eine Abhängigkeit anhebt, lässt Sie nicht sagen, welche der drei Ursachen das nächste Problem verursacht hat — und macht Schritt 5 unmöglich.
Zwei Regeln:
- Ein Commit, eine Ursache. Finden Sie beim Beheben ein zweites Problem, legen Sie ein eigenes Ticket an.
- Refactoring bekommt eigene Zeit. Während einer Korrektur mischt es bekanntes mit unbekanntem Risiko.
Schritt 5: Verifizieren — beweisen, dass behoben, nicht versteckt
Hier unterscheidet sich dieser Artikel von den meisten „So behebt man Bugs"-Texten. Alle vier folgenden Muster lassen den Defekt verschwinden, während das Problem bleibt:
| Vorgehen |
Oberflächlich |
Tatsächlich |
Leeres try / catch |
Der Fehler ist weg |
Nachgelagerte Logik scheitert still, Daten werden falsch geschrieben |
| Validierung lockern |
Keine Fehler mehr |
Schmutzige Daten landen in der DB, Monate später entdeckt |
| Einstiegspunkt verstecken |
Nutzer können nicht mehr klicken |
Das Bedürfnis bleibt, es kommt über einen anderen Weg, Verhalten weicht ab |
| Ein Flag, das nie wieder aus geht |
Das Symptom tritt nicht auf |
Das Flag wird Code, den niemand zu löschen wagt |
Der einzig gültige Test: Kann der Nutzer jetzt tun, was er tun wollte? Nicht „ist der Fehler weg".
Verifikation hat drei Teile:
Den ursprünglichen Pfad gehen — genau die im Bericht beschriebene Route, vom ersten bis zum letzten Schritt.
Die Ränder erneut versuchen — leere Werte, sehr langer Text, Emoji, Zeitzonen, Geldbeträge mit Dezimalen, ein Konto ohne Berechtigung. Diese sechs sind, wo Rückfälle wohnen.
Die Regressionsmatrix laufen lassen — welche alte Funktionalität diese Änderung berührt haben könnte, siehe wie man Regressionstests durchführt.
Schritt 6: Mit einer Zeile Ursache schließen
Einen Defekt mit „behoben" zu schließen, verschiebt die Kosten auf die nächste Person. Eine vollständige Ursachennotiz hat drei Teile:
text
Ursache: beim Bestellabschluss wurde das Formular vor dem Absenden geleert,
eine fehlgeschlagene Anfrage hinterließ also ein leeres Formular;
der erneute Versuch sendete leere Daten, bekam 500, ein stilles
catch schluckte es.
Korrektur: erst senden, bei Erfolg leeren; stilles catch entfernt und
stattdessen eine Fehlermeldung angezeigt.
Verifiziert: Chrome 141 / macOS 14, drei Versuche mit deaktiviertem Netz
zeigten „Senden fehlgeschlagen, bitte erneut versuchen" und
behielten die Formularinhalte; Regression: Checkout, Gutscheine,
Adressbuch.
Diese drei Teile beantworten „warum war es kaputt", „was wurde geändert" und „wie wurde es bewiesen". Sie überleben den Diff — sechs Monate später ist der Diff umgeschrieben, die Datei aufgeteilt, das Modul ersetzt, und der Kommentar steht noch da.
Belege gehören nicht nur in den Chat. Screenshots, Aufzeichnungen und fehlgeschlagene Anfragen müssen beim Datensatz bleiben, sonst führt „wie sah das damals aus" in drei Monaten, wenn die Regression fehlschlägt, auf einen toten Bildhoster-Link. Die BugCapturer-Erweiterung nimmt Konsolenfehler, fehlgeschlagene Anfragen, Seiten-URL, Browser und Viewport beim Absenden mit und erzeugt einen teilbaren Link; im Team-Plan werden Berichte langfristig aufbewahrt — aus einem einfachen Grund: damit „der ursprüngliche Bericht lässt sich noch öffnen" auch in drei Monaten stimmt.
Warum Reproduktion scheitert: drei reale Ursachen
„Nicht reproduzierbar" ist ein schwarzes Loch im Defekt-Tracker. Es ist selten Glück; es ist einer von drei Unterschieden.
1. Umgebung. Die üblichen fünf: Build-Version (lokal läuft neuestes main), Caches (Browser, Service Worker, CDN), Feature-Flags, Rollen und Rechte, Zeitzone und Sprache. Der Handgriff ist, diese fünf einzeln abzugleichen, nicht jemanden erneut versuchen zu lassen.
2. Daten. Im Datensatz des Nutzers steht eine 300-Zeichen-Notiz, ein Emoji-Spitzname, ein null-Zweitname, ein negativer Betrag. Die Oberfläche ist auf „normalen Daten" immer korrekt. Wer reproduzieren kann, hat meist die konkrete Datensatz-ID.
3. Zeitverhalten. Asynchrone Rennen, Lazy Loading, Debounce, Reihenfolge von Drittanbieter-Callbacks. Diese erscheinen nie auf schneller Leitung und immer auf langsamer; auf der Entwicklermaschine sind sie immer in Ordnung. Das Werkzeug ist Drosselung und künstliche Verzögerung, nicht mehr Logging.
Wenn Sie nicht reproduzieren können, halten Sie es fest als geparkt + Liste der bereits versuchten Bedingungen + drei Fragen (Einstieg / Konto / Zeitpunkt). Schließen ist die schlechteste Option — Sie verlieren die Information, dass es überhaupt passiert ist, und es kommt wieder.
Patch, Hotfix, reguläre Korrektur: drei Tempi, nicht mischen
Derselbe Bug nimmt einen von drei Wegen, abhängig von Wirkung und Dringlichkeit, nicht von Schwierigkeit:
| Reguläre Korrektur |
Patch |
Hotfix |
| Situation |
Hauptfluss nicht blockiert, kann warten |
Kleiner Umfang, muss aber bald raus |
Produktion steht / Geld betroffen / Sicherheit |
| Prozess |
Normale Iteration mit Review |
Geht mit der nächsten Minor-Version raus |
Umgeht den Normalprozess, Review danach |
| Pflicht-Zusatz |
Regressionsmatrix |
Regressionsmatrix + Änderungsnotiz |
Regressionsmatrix + Änderungsnotiz + Incident-Review |
| Wird am häufigsten vergessen |
Randfall-Verifikation |
Betroffene Nutzer informieren |
Symptom beheben statt Ursache |
Das Risiko beim Hotfix ist nicht die Geschwindigkeit, sondern dass danach niemand zurückkommt. Provisorische Änderungen bleiben im Code, Regression wird nie ergänzt, das Review nie geschrieben. Ein Hotfix sollte drei Dinge hinterlassen: eine Release-Notiz, einen gezielten Regressionslauf und einen Satz dazu, wie das überhaupt in Produktion gelangen konnte. Release-Notizen stehen im Changelog.
Fünf Regeln fürs Team
Wenn nur fünf Dinge hängen bleiben:
Nicht startbare Berichte zurückgeben statt raten. Zwei Minuten Zurückgeben gegen vierzig Minuten Raten.
Ein Commit, eine Ursache. Gemischte Änderungen lassen sich weder verifizieren noch zurückrollen.
Mit Ursache und Beleglink schließen. Die eine Regel, die jemandem in sechs Monaten einen Tag spart.
„Nicht reproduzierbar" ist ein Grund zum Parken, nicht zum Schließen.
Eine Korrektur ohne Matrix-Nachtrag ist nicht fertig. Die Zeile, die Sie übersprungen haben, ist der Eingang des nächsten Incidents.
Die Grenze zwischen Defekt, Anforderung, Fehler und Bug verschwimmt — siehe Bug vs. Defect vs. Issue vs. Error. Wenn es um „wie sagen wir dem Kunden, dass es behoben ist" geht: Fehlerberichte mit Kunden teilen.
Häufige Fragen
Wie priorisiere ich Bugfixes gegen neue Features?
Nach Wirkung mal Häufigkeit, nicht nach Lautstärke. Die Matrix aus Schweregrad und Priorität steht im Triage-Leitfaden. Eine Ergänzung: die Warteschlange nicht mitten im Sprint umsortieren. Teams, die ständig neu triagieren, schaffen meist keine der beiden Spuren.
Darf ich mehrere Bugs in einer Änderung beheben?
Nur bei einer Ursache und einer Stelle — eine Ursache mit drei Symptomen ist ein Bug. Unabhängige Ursachen in einem Commit machen Rollback unmöglich: bei einem Produktionsproblem können Sie nur alles zurücknehmen.
Braucht jeder Bug einen Unit-Test?
Nein. Drei Sorten verdienen einen: wiederkehrende (mit Regressionshistorie), solche mit verzweigter Logik (viele Randfälle) und alles, was Daten berechnet (Beträge, Verhältnisse, Daten). Reine Anzeige- und Textkorrekturen deckt der Regressionsdurchgang ab.
Ich habe beim Beheben ein weiteres Problem gefunden. Gleich mitbeheben?
Nein. Eigenes Ticket. Es hineinzumischen entwertet Schritt 5 — Sie können nicht sagen, welche Änderung das Problem beseitigt hat.
Sollten wir Nutzer nach einem Produktions-Bug informieren?
Wenn übermittelte Daten, Beträge oder Bestellstatus betroffen waren: proaktiv informieren und sagen, was repariert wurde. War es eine kurze Nichtverfügbarkeit, die behoben ist, reicht ein Status-Update. Im Changelog festgehalten, beantwortet das auch „gibt es dafür einen Nachweis", wenn ein Kunde fragt.