24FreelanceFreelance-Marktplatz, der niemals schläft
Freelance-Karriere 9 min 9 Abschnitte

Fehlerhaften Code von Freelancern richtig melden

So erkennst du fehlerhaften Code, dokumentierst Fehler sauber und meldest sie sachlich, damit der Freelancer schnell nachbessern kann.

Dmitry24 Freelance-Mitglied9 min lesen46 Ansichten0
Inhalt 0%
  1. 01Was tun, wenn ein Freelancer fehlerhaften Code liefert
  2. 02Was zählt als „fehlerhafter Code“ und was als normaler Bug?
  3. 03Was solltest du zuerst prüfen, bevor du den Freelancer kontaktierst?
  4. 04Wie solltest du fehlerhaften Code melden, ohne daraus einen Streit zu machen?
  5. 05Welche Belege solltest du teilen, damit der Freelancer schneller reparieren kann?
  6. 06Wann solltest du um einen Fix, einen Rollback oder eine Rückerstattung bitten?
  7. 07Was, wenn der Freelancer sagt, der Code funktioniere bei ihm?
  8. 08Wann wird fehlerhafter Code zu einem Übergabe- oder Besitzproblem?
  9. 09Wie verhinderst du beim nächsten Mal dasselbe Lieferproblem?

Was tun, wenn ein Freelancer fehlerhaften Code liefert

Was tun, wenn ein Freelancer fehlerhaften Code liefert

Fehlerhafter Code ist nicht dasselbe wie ein normaler Bug. Ein normaler Bug steckt in einer Funktion, die im Großen und Ganzen funktioniert; fehlerhafter Code kann ein Release stoppen, einen Login blockieren oder eine Datei vom ersten Tag an unbrauchbar machen. Dieser Unterschied ist wichtig, denn dein nächster Schritt sollte zum Ausmaß des Schadens passen, nicht zu deinem Frust.

Beginne mit einer Frage: Kann irgendjemand es gefahrlos nutzen? Wenn nein, behandle es als Lieferproblem, nicht als Feinschliff. Wenn ja, aber ein einzelner Ablauf scheitert, hast du wahrscheinlich einen Defekt, der trotzdem korrigiert werden muss. Einfach, aber hilfreich.

Was zählt als „fehlerhafter Code“ und was als normaler Bug?

Fehlerhafter Code zeigt sich meist in 3 Formen: unvollständige Arbeit, instabile Arbeit oder Arbeit, die im vereinbarten Setup nicht laufen kann. Ein Formularbutton, der beim Absenden einen Fehler auslöst, ist ein Bug. Ein Checkout-Prozess, der nie zur Zahlung gelangt, weil der Freelancer die Validierung, die Routing-Datei oder den nötigen API-Hook ausgelassen hat, ist fehlerhafter Code.

Schau zuerst auf den Umfang. Wenn der Freelancer einen Page Builder versprochen und nur den Header geliefert hat, ist das kein kleiner Mangel. Wenn der Freelancer ein Skript geliefert hat, das von einer Datei abhängt, die nirgends erwähnt wurde, ist das ebenfalls kein kleiner Mangel. Der Code mag existieren, die Lieferung ist trotzdem fehlerhaft.

Ein praktischer Test hilft: Lässt sich der Code in unter 5 Minuten mit dem vereinbarten Ergebnis abgleichen? Wenn du dafür verstecktes Wissen, geheime Einrichtungsschritte oder eine private Erklärung brauchst, ist das Problem größer als ein Tippfehler. An diesem Punkt sollten viele Kunden ihre Notizen noch einmal prüfen und bei Bedarf den Fall mit wie man einen Freelancer sicher beauftragt für das nächste Projekt vergleichen.

Was solltest du zuerst prüfen, bevor du den Freelancer kontaktierst?

Reproduziere das Problem einmal, bevor du schreibst. Zweimal ist besser. Verwende nach Möglichkeit denselben Browser, dasselbe Gerät und denselben Account. Notiere genau, worauf du geklickt hast, was passiert ist und wo der Fehler aufgetreten ist. „Es funktioniert nicht“ ist zu ungenau, um jemandem zu helfen.

Dann halte die Umgebung fest. Notiere Browsername, Version, Betriebssystem, Server-URL und ob du Staging oder Produktion genutzt hast. Ein Codepfad, der in Chrome auf einem Laptop funktioniert, kann in Safari auf einem Smartphone scheitern, und dieser Unterschied kann später viel Hin und Her ersparen.

Sammle die harten Beweise, solange alles noch frisch ist: Screenshots, Konsolenmeldungen, Serverlogs, Fehler-IDs und den Zeitstempel des Fehlers. Wenn der Bug nach einem Deploy auftritt, notiere die genaue Datei oder Version, die du erhalten hast. Diese Details machen aus einer vagen Beschwerde einen brauchbaren Bericht.

Ändere nicht drei Dinge auf einmal. Wenn du die Konfiguration bearbeitest, den Datensatz austauschst und den Dienst neu startest, kann niemand sagen, welche Änderung den Fehler ausgelöst hat. Halte einen Testpfad unverändert.

Wie solltest du fehlerhaften Code melden, ohne daraus einen Streit zu machen?

Halte die erste Nachricht kurz, sachlich und mit Datum. Eine gute Struktur ist: 1) Was ist fehlgeschlagen, 2) wo ist es fehlgeschlagen, 3) was hast du erwartet, 4) was brauchst du als Nächstes. Das reicht, um ein Gespräch über die Korrektur zu eröffnen, ohne anklagend zu klingen. Wenn du fehlerhaften Code melden Freelancer möchtest, hilft genau diese klare Form.

Beispiel: „Auf der Staging-Seite gibt das Kontaktformular nach dem Absenden einen 500-Fehler zurück. Ich hatte erwartet, dass das Formular die Nachricht sendet und eine Bestätigung anzeigt. Ich habe den Screenshot und das Konsolen-Log angehängt. Bitte bestätigen Sie die Ursache und senden Sie einen Fix oder einen korrigierten Build.“

Diese Formulierung lässt keinen Raum für Theater. Sie vermeidet auch die Falle, dem Freelancer eine Absicht zuzuschreiben, die du ohnehin nicht beweisen kannst. Halte den Satz über die Auswirkungen konkret: „Kunden können keine Bestellungen abschicken“, „das Admin-Panel friert ein“ oder „die exportierte Datei ist leer“. Diese Details sind wichtiger als Emotionen.

Wenn das Projekt öffentlich sichtbare Arbeit betrifft, sollte die Nachricht die Folge klar benennen. Eine fehlerhafte Landingpage kann in wenigen Stunden ein Marketingbudget verbrennen; ein fehlerhafter Checkout kann sofort Verkäufe kosten. Niemand braucht einen dramatischen Absatz, um das zu verstehen.

Welche Belege solltest du teilen, damit der Freelancer schneller reparieren kann?

Sende die Schritte zur Reproduktion in der richtigen Reihenfolge, nicht als Geschichte. Schritt 1: einloggen. Schritt 2: Dashboard öffnen. Schritt 3: Export klicken. Schritt 4: Der Download schlägt fehl. Eine solche Liste ermöglicht es dem Freelancer, deinen Weg exakt nachzugehen. Am besten solltest du den Bug an Freelancer dokumentieren, damit die Ursache nachvollziehbar bleibt.

Füge die Testdaten hinzu, die das Problem ausgelöst haben, etwa einen Demo-Account, einen Beispieldatensatz oder einen bestimmten Dateinamen. Wenn der Code von einer Spracheinstellung, einer Browser-Erweiterung oder einer bestimmten Umgebungsvariable abhängt, erwähne das. Ein fehlendes Detail kann einen ganzen Nachmittag kosten.

Teile Versionsinformationen zum eigentlichen Lieferumfang. Wenn du „v3“ erhalten hast, sag das. Wenn der Freelancer nach deiner letzten Prüfung einen Patch eingespielt hat, sag, welcher Patch es war. Wenn es ein privates Repository gibt, füge den Branchnamen und den Commit-Hash hinzu.

Dateien helfen, aber nur die richtigen. Ein Screenshot eines leeren Bildschirms ist nützlich. Eine 4-minütige Bildschirmaufnahme kann sogar noch besser sein, wenn sie die Klicks und den Fehler in einem Durchgang zeigt. Hier wird der Ausdruck Freelancer-Bewertungen manchmal relevant, weil sich ein Muster unklarer Übergaben dort oft zeigt, bevor es im Code sichtbar wird.

Wann solltest du um einen Fix, einen Rollback oder eine Rückerstattung bitten?

Wähle die Maßnahme nach Schweregrad, nicht nach Frust. Wenn der Bug klein ist und die Codebasis sonst nutzbar bleibt, bitte um einen Fix. Wenn der fehlerhafte Code einen Launch blockiert oder Daten beschädigt, kann ein Rollback der schnellste sichere Weg sein. Wenn der Liefergegenstand unbrauchbar oder unsicher zu reparieren ist, wird eine Rückerstattung vernünftig. Genau dann stellt sich oft die Frage: Freelancer liefert fehlerhaften Code was tun.

Stelle eine direkte Frage: Lässt sich das beheben, ohne andere Teile des Projekts zu beschädigen? Wenn die Antwort unklar ist und der Freelancer nur rät, schützt dich ein Rollback möglicherweise besser als Warten. Ein schlechter Patch kann aus einem kaputten Modul drei kaputte Module machen.

Rückerstattungen sollten nicht die erste Drohung in Nachricht 1 sein. Sie gehören erst nach einer klaren Prüfung der Belege und der Lieferbedingungen dazu. Wenn die Arbeit jedoch nicht vor Ort repariert werden kann oder der Freelancer zugibt, dass die Architektur falsch ist, solltest du die Datei nicht mehr so behandeln, als wäre sie nur noch einen Schritt vom Fertigen entfernt.

Hier gibt es eine praktische Grenze. Wenn ein Release Umsatz blockiert, kostet jede Stunde Verzögerung Geld, auch wenn du es nicht auf den Cent genau berechnest. Wenn das Projekt privat und risikarm ist, kann die Behebung länger warten. Der Kontext zählt.

Was, wenn der Freelancer sagt, der Code funktioniere bei ihm?

Betrachte diese Antwort nicht als Streit, sondern als Hinweis. In vielen Fällen liegt ein Unterschied in der Umgebung vor: Auf einem Rechner sind Abhängigkeiten zwischengespeichert, ein anderer nutzt eine andere Node-Version, oder ein Server verbirgt eine fehlende Datei hinter einem lokalen Einrichtungsschritt.

Bitte um das genaue Setup, das der Freelancer verwendet hat. Fordere die Versionsnummern, Installationsschritte und alle manuellen Schritte an, die nach dem Klonen oder Hochladen nötig waren. Wenn er sagt „lokal hat es funktioniert“, brauchst du das lokale Rezept, nicht Beruhigung. Genau darum geht es.

Manchmal hängt der Code von einer stillschweigenden Annahme ab. Der Freelancer hat vielleicht angenommen, dass ein Admin-Account existiert, dass eine Konfigurationsdatei bereits vorhanden war oder dass die Datenbank schon einen Seed-Datensatz enthält. Diese Annahmen hätten dokumentiert werden sollen, aber jetzt besteht die unmittelbare Aufgabe darin, sie Schritt für Schritt offenzulegen.

Bleib ruhig im Ton, auch wenn die Antwort ausweichend wirkt. Ein Satz wie „Bitte senden Sie mir die genauen Einrichtungsschritte, die Sie verwendet haben, damit ich sie mit meiner Umgebung vergleichen kann“ reicht aus. Wenn der Freelancer kooperativ ist, schließt sich die Lücke oft schnell. Wenn nicht, weißt du immerhin, dass das Problem nicht mehr nur technischer Natur ist.

Wann wird fehlerhafter Code zu einem Übergabe- oder Besitzproblem?

Fehlerhafter Code wird zu einem Übergabeproblem, wenn die Dateien ohne die nötigen Schritte zur Ausführung ankommen. Dazu gehören fehlende Installationshinweise, fehlende Zugangsdaten, fehlende Umgebungsdateien und fehlende Deploy-Anweisungen. Der Code kann vorhanden sein; die Übernahme ist es nicht.

Das passiert oft in Projekten, die von einem Team abhängen, nicht von einer Einzelperson. Ein Entwickler schickt ein Repository, aber die Server-Zugangsdaten liegen in einer privaten Nachricht. Ein Designer übergibt ein Website-Theme, aber das Build-Tool wird nie genannt. Ein Backend-Skript läuft nur auf dem Rechner des Freelancers, weil der Rest des Setups nie dokumentiert wurde.

Dann lautet die Frage nicht mehr nur „Behebe diesen Bug“. Sie lautet: „Kann mein Team diese Arbeit überhaupt übernehmen?“ Wenn die Antwort nein ist, ist die Lieferung unvollständig, selbst wenn jede Datei ordentlich aussieht. Hier können die Regeln von den Regeln der Website 24freelance.pro. freelance ein nützlicher Bezugspunkt dafür sein, wie Arbeit, Dateien und Kommunikation gehandhabt werden sollten.

Manche Teams brauchen außerdem eine Übergabe-Checkliste, bevor sie das Projekt akzeptieren. Eine Zeile für den Zugang. Eine Zeile für das Hosting. Eine Zeile für Admin-Zugangsdaten. Eine Zeile für die Ordnerstruktur. Ohne das kann die Übergabe scheitern, selbst wenn der Code selbst in Ordnung ist.

Wie verhinderst du beim nächsten Mal dasselbe Lieferproblem?

Formuliere die Abnahmekriterien, bevor die Arbeit beginnt. Kein Absatz. Eine Liste. „Login funktioniert mit gültigen Zugangsdaten.“ „Export erzeugt eine CSV mit 3 Spalten.“ „Das Formular sendet die E-Mail und zeigt eine Erfolgsmeldung.“ Solche Zeilen machen fehlerhaften Code leichter erkennbar, weil das Ziel sichtbar ist.

Bitte im Voraus um Testfälle, vor allem bei Funktionen mit 2 oder mehr Verzweigungen. Wenn der Freelancer weiß, wie du testen wirst, baut er eher für die tatsächliche Prüfung als für eine ausgedachte. Auch eine Prüfung in der Staging-Umgebung hilft, weil sie fehlerhaften Code findet, bevor jemand ihn als fertig bezeichnet.

Definiere „fertig“ mit einem Satz, der Dateien, Zugriff und Nachweis enthält. Zum Beispiel: „Fertig heißt, dass der Code auf unserem Staging-Server läuft, die README die Einrichtungsschritte enthält und das Testkonto den Hauptablauf bestätigt.“ Diese Definition löst keine schlechte Arbeit, aber sie macht schlechte Arbeit früher sichtbar.

Bei komplexen Aufgaben solltest du um eine kurze Übergabenotiz bitten. Schon 5 Stichpunkte können später viel sparen: Umgebung, Abhängigkeiten, bekannte Einschränkungen, Testdaten und wer den nächsten Schritt übernimmt. Kleine Bitte, großer Nutzen.

Eine letzte praktische Gewohnheit: Halte den Projekt-Chat und die endgültige Dateiliste am selben Ort. Wenn der Freelancer einen Fix per E-Mail schickt, die Deploy-Notiz aber im Chat liegt und das Serverpasswort in einer Tabelle steht, ist die Übergabe fragil. Fragile Übergaben scheitern unter Druck.

Fanden Sie es nützlich? Teilen Sie es
Artikelautor
Dmitry
24 Freelance-Mitglied
281 Artikel21 584 Lesungenauf der Plattform seit 2015
24
24 Freiberufler

Bereit, das in die Praxis umzusetzen?

Poste ein Projekt kostenlos — Freiberufler antworten mit Preisen und Fristen, und die Zahlung erfolgt über einen sicheren Deal.

Kommentare 0

24Einloggen oder registrieren, um einen Kommentar zu hinterlassen.

Noch keine Kommentare — sei der Erste.

Was diese Seite beantwortet