Zurück zum Blog

Wie wir arbeiten

Load failed ist keine Fehlermeldung

Von Maria Catalina Kovacs · 19. Oktober 2026 · 7 Min. Lesezeit

Ein Satz, der auf drei verschiedene Probleme zutrifft, ist keine Fehlermeldung. Er ist ein Achselzucken mit guter Grammatik.

Wir bauen dieses Unternehmen öffentlich auf. Das heißt, wir erzählen, was wir tun, während wir es tun, auch die Teile, die schiefgehen. Dies ist einer davon. Zwei Systeme fielen am selben Tag aus, beide bestanden ihre Tests, und keines sagte, warum.

Worum es ging, damit das Folgende Sinn ergibt

Wir betreiben zwei kleine Websites ohne Server dahinter: statische Dateien im Speicher, ein Content Delivery Network davor und eine Handvoll Funktionen für das Wenige, das eine statische Datei nicht kann. Eine dieser Funktionen verwaltet Kommentare. Jemand schreibt etwas, die Funktion speichert es, und die Autorin wird benachrichtigt, damit sie es liest, bevor es irgendwo erscheint.

Diese Woche kamen zwei Dinge dazu. Ein Link in der Benachrichtigungsmail, der einen einzelnen Kommentar mit seinen Schaltflächen öffnet, damit das Freigeben ein Tippen kostet statt einen Schlüssel zu suchen und einzugeben. Und eine Benachrichtigung, die direkt auf einem Telefon ankommt, damit ein Kommentar nicht ungelesen liegen bleibt, bis jemand wieder am Schreibtisch sitzt.

Beides entstand gemeinsam mit einem KI-Assistenten, so wie hier alles entsteht und worum es in diesem Unternehmen eigentlich geht. Nicht zuschauen. Nicht die Schlüssel übergeben. Zusammenarbeiten, so wie mit einer sehr schnellen Kollegin, die Ihr Geschäft noch nie gesehen hat.

Beides ging live. Beides bestand die Tests. Beides war kaputt.

Das erste sagte: Hier ist nichts

Der Link ging per Mail hinaus, wurde angetippt und öffnete eine Seite mit dem Text: Hier ist nichts. Diese Adresse öffnet nichts. Entweder wurde der Kommentar bereits gelöscht, oder der Link wurde auf dem Weg hierher verändert.

Er war nicht gelöscht. Der Link war nicht verändert. Der Kommentar lag in der Datenbank und wartete darauf, gelesen zu werden.

Sehen Sie sich diesen Satz einen Moment an, denn er ist der Bösewicht dieses Beitrags. Er ist höflich, er ist gut geschrieben, und er deckt drei völlig verschiedene Fehler mit einer einzigen Formulierung ab: der Datensatz ist weg, die Signatur stimmt nicht, oder die Seite hat den Server gar nicht erreicht. Drei Ursachen, drei verschiedene Lösungen, eine Meldung, die keine davon unterscheidet.

Ein Satz, der auf drei verschiedene Probleme zutrifft, ist keine Fehlermeldung. Er ist ein Achselzucken mit guter Grammatik.

Der eigentliche Fehler, und warum kein Test ihn finden konnte

Die Funktion liest einen einzelnen Kommentar über seine beiden Schlüssel. In der Datenbank ist das eine andere Operation als die, die überall sonst im System verwendet wird, mit einem anderen Namen und daher einer anderen Berechtigung.

Der Code bekam diese Operation. Die Rolle nicht.

Also fragte die Funktion nach dem Datensatz, der Cloud-Anbieter verweigerte ihn, die Funktion lief auf einen Fehler, und die Seite sagte: hier ist nichts. Alles andere funktionierte weiterhin einwandfrei, weil alles andere die bereits erteilten Berechtigungen benutzte.

Jetzt der Teil, den es sich zu stehlen lohnt. Es gab zu diesem Zeitpunkt vierundneunzig Tests für diese Funktion, und alle bestanden. Sie bestehen immer noch. Es sind gute Tests, und sie hätten das unmöglich finden können.

Der Grund ist eine Entwurfsentscheidung, die wir wieder so treffen würden. Der Handler spricht nie direkt mit der Datenbank. Er bekommt einen Store übergeben, und in den Tests ist dieser Store eine Attrappe. Genau das lässt die gesamte Suite in unter einer Sekunde laufen, ohne Cloud-Konto, ohne Netzwerk, ohne Zugangsdaten. Das ist der richtige Entwurf.

Aber eine Attrappe kann keine Berechtigung verweigern. Die Tests bewiesen die Logik und waren strukturell außerstande, den Zugriff zu beweisen.

Es gab zwei Listen. Die Operationen im Code und die Berechtigungen in der Rolle. Nichts hielt sie im Gleichschritt außer jemandem, der es bemerkt. Diesen Satz haben wir jetzt in das Deployment-Dokument geschrieben, denn die nächste Funktion wird dieselbe Form und dieselbe Lücke haben.

Das zweite sagte: Load failed

Wir reparierten also die Berechtigung und machten uns an die Benachrichtigungen, die nicht auf dem Telefon ankamen.

Wir bauten eine Schaltfläche in das Produkt ein, die eine Testbenachrichtigung sendet, damit die Antwort dort ankommt, wo das Problem ist, nämlich auf dem Telefon, und nicht in einer Logdatei auf einem Rechner im anderen Zimmer. Gedrückt. Zwei Wörter zurück. Load failed.

Das ist nicht unsere Formulierung. Das ist die des Browsers. Und es lohnt sich zu verstehen, was sie genau bedeutet, denn sie ist einer der irreführendsten Zweiwörtersätze der Webentwicklung.

Sie bedeutet nicht, dass das Netzwerk ausgefallen ist. Sie bedeutet, dass der Browser die erhaltene Antwort nicht lesen durfte.

Wenn eine Funktion eine Ausnahme wirft, die niemand abfängt, liefert die Plattform einen allgemeinen Serverfehler. Diese Antwort entsteht, bevor unser Code läuft, und trägt deshalb nicht die Cross-Origin-Header, die unser Code jeder Antwort mitgibt. Ohne diese Header lässt der Browser die Seite die Antwort überhaupt nicht lesen und meldet es als Netzwerkfehler.

Der Server hat also etwas Konkretes und Nützliches gesagt. Dem Browser war verboten, es uns zu zeigen. Wir bekamen zwei Wörter, die nirgendwohin zeigen.

Die Lösung sind drei Zeilen und ein Prinzip

Die gesamte Funktion ist jetzt umschlossen. Nichts entkommt ihr.

die Grenze der Funktion
return async function handler(event) {
  const origin = headerOf(event, 'origin') ?? '';
  try {
    return await route(event, origin);
  } catch (err) {
    console.error('handler threw:', err?.stack ?? err);
    return reply(500, {
      error: 'server_error',
      detail: String(err?.message ?? err).slice(0, 300),
    }, origin);
  }
};

 

Das Wichtige ist nicht das try und das catch. Es ist, dass origin in die Fehlerantwort übergeben wird. Eine Nachricht, die der Browser nicht lesen kann, ist keine Nachricht. Wir haben einen Test geschrieben, der eigens prüft, dass der Cross-Origin-Header auf der Fehlerantwort vorhanden ist, denn dieser Header ist der Unterschied zwischen einem Satz und einer Wand.

Was es sagte, sobald es sprechen durfte

Wir drückten die Schaltfläche erneut und bekamen einen echten Satz: die Schlüssel wurden abgelehnt, der private Schlüssel muss URL-sicheres Base 64 ohne Gleichheitszeichen sein, öffentlich 87 Zeichen, privat 56 Zeichen.

Ein Schlüssel dieser Art hat dreiundvierzig Zeichen. Sechsundfünfzig sind dreizehn zu viele, und das ist fast genau die Länge der Beschriftung, die das erzeugende Werkzeug darüber druckt.

Die Beschriftung war zusammen mit dem Schlüssel kopiert worden, in ein Konsolenfeld, wo sie völlig normal aussah.

Ein Abend Arbeit, und der Fehler waren dreizehn Zeichen Interpunktion, die nichts im System bereit war auszusprechen.

Die Funktion schneidet diese Werte jetzt vor der Verwendung zu, und wenn ein Schlüsselpaar abgelehnt wird, meldet sie die Ablehnung mitsamt der Länge beider Schlüssel, statt eine Ausnahme zu werfen und die ganze Anfrage mitzunehmen.

Drei Regeln, und es geht nicht um die Cloud

Nichts davon ist an einen Anbieter, eine Sprache oder eine Architektur gebunden. Drei Dinge folgen daraus, die vor zwanzig Jahren genauso gegolten hätten.

  • <b>Eine Fehlermeldung, die auf mehr als eine Ursache passt, ist ein Fehler.</b> Kein Schönheitsproblem, ein Fehler, und meist der teuerste im System. Wenn derselbe Satz auf drei verschiedene Ausfälle zutreffen kann, muss die lesende Person alle drei untersuchen. Schreiben Sie für jeden einen eigenen Satz.
  • <b>Nichts darf oben aus Ihrem System still hinausfallen.</b> Umschließen Sie die Grenze. Geben Sie eine echte Antwort mit einer echten Nachricht zurück, und sorgen Sie dafür, dass der Aufrufer diese Antwort auch lesen darf. Eine Ausnahme, die die Plattform erreicht, wird zu einer Antwort, die Sie nicht mehr kontrollieren.
  • <b>Stellen Sie die Diagnose dorthin, wo der Mensch ist.</b> Unsere Logs lagen in der Cloud-Konsole, nützlich am Laptop und nutzlos, wenn das kaputte Gerät ein Telefon in der Hand ist. Die Testschaltfläche im Produkt kostete zwanzig Minuten und beendete einen Abend des Ratens mit einem Druck.

Der ehrliche Teil, und es geht nicht darum, wer getippt hat

Die naheliegende Fassung dieser Geschichte lautet, der Assistent habe den Fehler geschrieben. So war es nicht, und es wäre auch keine nützliche Lehre.

Hier war es, wie immer, Zusammenarbeit. An manchen Tagen schreibt der Assistent den Code. An manchen wir. In diesem Fall spielt es keine Rolle, denn der Fehler wäre so oder so derselbe gewesen.

Tatsächlich passiert ist Folgendes: Der Code wurde gegen eine Annahme darüber geschrieben, welche Berechtigungen existieren. Die Tests wurden gegen dieselbe Annahme geschrieben, und zwar absichtlich, denn die Attrappe existiert gerade deshalb, damit die Tests nicht von der echten Datenbank abhängen. Und die Durchsicht geschah gegen dieselbe Annahme, weshalb sie bestanden wurde.

Dieser Fehlermodus hat nichts damit zu tun, wer die Tastatur hielt, und alles damit, ob irgendetwas im Raum auf die Wirklichkeit geschaut hat statt auf ein vereinbartes Bild von ihr.

Drei Dinge stimmten miteinander überein. Keines davon hatte den Cloud-Anbieter gefragt.

Wenn Sie gerade etwas mit KI bauen

Gut mit einem Assistenten zu arbeiten heißt nicht, bessere Anweisungen zu schreiben. Es heißt, dafür zu sorgen, dass irgendetwas im Prozess prüft, was tatsächlich passiert ist, und nicht, was alle erwartet haben.

Eine Attrappe, ein bestandener Test und eine selbstsichere Durchsicht können sich alle einig sein und trotzdem ein System beschreiben, das es nicht gibt. Irgendetwas muss das echte fragen gehen.

Und wenn es nicht funktioniert, hat Ihr System genau eine Aufgabe: Ihnen zu sagen, was es versucht hat und was verweigert wurde.

Raten wird nach Stunden abgerechnet. Ein System, das sagt, was es versucht hat und was verweigert wurde, ist das Billigste, das Sie je bauen werden.

MK!

Maria Catalina Kovacs

Auf dieser Seite gibt es kein Tracking. Keine Analyse, keine Cookies, nichts, das aufzeichnet, wo Sie waren oder wie lange Sie geblieben sind.

Aber ich würde gerne wissen, ob hier etwas Ihre Zeit wert war. Wenn ja, drücken Sie das Herz. Es verrät mir nichts über Sie. Es ist eine Zahl, die steigt, und sie ist der Grund, warum ich weiterschreibe.

Diesen Artikel teilen

XLinkedIn

Wenn Sie mehr davon möchten, finden Sie mich auf X. @Queendemetriak