◇ Etwas funktioniert nicht
Python- & API-Fehlerbehebung
Ein Skript, ein Import, eine Schnittstelle: irgendwas bricht ab.
- So klingt es
„Das Python-Skript läuft seit dem Update nicht mehr durch und ich weiß nicht, wo ich anfangen soll.“
- Was dahintersteckt
Häufige Auslöser sind eine geänderte Abhängigkeit, ein verschobenes Datenformat oder eine Schnittstelle, die ihre Antwort geändert hat. Welcher davon zutrifft, zeigt der Blick in Meldung, Stacktrace und Umgebung.
- Was ich zuerst prüfe
Fehlermeldung und Stacktrace, Versionsstände der Abhängigkeiten, ein Testlauf mit echten Daten, Antwortformat der beteiligten Schnittstelle.
- Woran Sie es merken
Läuft wieder. Dazu bekommen Sie, woran es lag und wie Sie es beim nächsten Mal selbst erkennen.
· Umfang
Typische Fälle
- Python-Skripte und Datenverarbeitung
- API- und Schnittstellenprobleme
- Browser-Automatisierung mit Playwright
- Zweitmeinung zu fremdem Code
Orientierungswert Kleinaufträge ab 90 €/h Klar abgegrenzte Fehler lassen sich häufig innerhalb weniger Stunden untersuchen und beheben. Den konkreten Rahmen erhalten Sie nach der Ersteinschätzung.
Manche Aufträge dauern zwei Stunden. Dafür gibt es bei den meisten Anbietern gar keinen Eingang, und genau deshalb bleiben solche Probleme oft monatelang liegen.
Schicken Sie mir die Fehlermeldung oder den Stacktrace. Anhand von Meldung, Stacktrace und Umgebung lässt sich der mögliche Umfang oft bereits grob eingrenzen.
Sie erhalten neben der Korrektur eine kurze Erklärung, damit der Fehler später schneller erkannt und eingeordnet werden kann.
Womit solche Skripte in der Praxis stehenbleiben
Die Meldung im Terminal nennt fast nie die Ursache, sondern die Stelle, an der die Ursache sichtbar wurde. Vier Gruppen decken den Großteil der Fälle ab:
Eine Abhängigkeit hat sich geändert. Ein pip install ohne feste Version holt beim nächsten Lauf eine neuere Fassung. Funktionen verschwinden, Vorgaben ändern sich, ein Rückgabewert ist plötzlich ein anderer Typ. Erkennbar daran, dass am Code selbst nichts geändert wurde und es trotzdem seit einem bestimmten Tag klemmt.
Die Daten sehen anders aus als angenommen. Eine zusätzliche Spalte, ein leeres Feld, ein Datum als Text statt als Datum, ein Komma statt eines Punkts, eine Datei in einer anderen Zeichenkodierung. Das Skript ist nicht kaputt, es bekommt nur etwas anderes, als es erwartet.
Die Schnittstelle antwortet anders. Ein Feld wurde umbenannt, die Antwort ist verschachtelt statt flach, ein Zugangsschlüssel ist abgelaufen, oder eine Abrufgrenze greift und liefert statt der Daten einen Fehlercode. Häufig ohne Ankündigung durch den Anbieter.
Die Umgebung ist eine andere. Auf dem eigenen Rechner läuft es, auf dem Server nicht: andere Python-Fassung, fehlende Systembibliothek, andere Zeitzone, andere Schreibrechte, ein Pfad, den es dort nicht gibt.
Was ich zum Anfangen brauche
Je mehr davon vorliegt, desto kürzer wird die Suche:
- Die vollständige Fehlermeldung samt Stacktrace, als Text kopiert und nicht als Bildschirmfoto
- Wann es zuletzt funktioniert hat und was dazwischen passiert ist
- Ob es immer auftritt oder nur bei bestimmten Daten
- Das Skript selbst oder der betroffene Ausschnitt
- Bei Schnittstellen: um welchen Dienst es geht
Wenn Sie nur die Fehlermeldung haben, genügt das für die erste Einschätzung.
Was es kostet, und was nicht
Die erste Einschätzung ist kostenlos: Ich sehe mir Meldung und Umfeld an und sage Ihnen, ob ich den Fehler für in wenigen Stunden lösbar halte oder für einen größeren Fall. Bezahlt wird erst ab der eigentlichen Untersuchung.
Es gibt keine Mindestauftragsgröße. Ein Fehler, der in zwei Stunden erledigt ist, wird mit zwei Stunden abgerechnet. Bevor die Arbeit beginnt, steht eine Obergrenze fest — wird sie erreicht, melde ich mich, statt weiterzulaufen.
· Nächster Schritt
Schildern Sie Ihren Fall
Die kurze Ersteinschätzung ist kostenlos: Ich lese Ihre Anfrage, sehe mir den öffentlich sichtbaren Zustand an und nenne Ihnen den nächsten sinnvollen Schritt. Sind für eine belastbare Diagnose Zugänge, Logs oder Testläufe nötig, geschieht das in einem vorher vereinbarten Kostenrahmen.