Fehlerbehebung
Die häufigsten Meldungen von RequestTailor, ihre Ursache und was du tun kannst. Texte in Kursivschrift stehen genau so in der Oberfläche; die Oberfläche ist englisch.
- Exit-Codes
- 0 bis 4, für
rt sendundrt run - Web-App
- vieles löst der Begleitdienst
rt agent - Hilfe
- Issues im Repo des Kerns oder CloudDNA
„The browser blocked this request“
Nur in der Web-App. Der Browser lässt keinen Request an einen Server ohne passende CORS-Header zu und keine verbotenen Header. RequestTailor bietet dann an, den Request über den Begleitdienst zu senden.
- Im Terminal
rt agentstarten. - In der Web-App Send through companion wählen und, beim ersten Mal, den Pairing code aus dem Terminal eintragen.
- Erneut senden. Der Request geht jetzt nativ von deinem Rechner hinaus.
Dasselbe gilt für gRPC, WebSocket und SSE: In der Web-App laufen sie immer über den Begleitdienst. Details und Sicherheitsmodell: Begleitdienst rt agent.
Client-Zertifikat: TLS-Fehler im Browser
Client-Zertifikate funktionieren nur nativ – in der Mac-App und mit rt. Browser und Begleitdienst lehnen sie mit einem klaren TLS-Fehler ab. Für APIs mit mTLS nimm die Mac-App oder rt send.
Skripte laufen nicht
| Lage | Ursache und Lösung |
|---|---|
| Banner „This collection contains scripts. Run them?“, Report mit Warnhinweis | Du hast der Collection noch nicht vertraut. Trust and run scripts klicken. Not now gilt bis zum nächsten Start. |
X is not supported in RequestTailor (…) | Das Skript nutzt eine API, die die Shims nicht abdecken. Der Verlustbericht des Imports nennt sie; die Liste steht in SHIM-COVERAGE.md. |
Cannot find module '…' | require lädt nur die eingebauten Module (crypto-js, lodash, moment, uuid, chai, tv4, ajv). |
| Skript bricht nach einigen Sekunden ab | Zeitgrenze von 5 Sekunden je Phase, Wartezeiten mit setTimeout oder rt.sleep eingerechnet; Speichergrenze 64 MiB. |
In rt run laufen keine Skripte | --no-scripts gesetzt? Assertions laufen auch dann. |
Mehr in Vertrauen und Postman-, Bruno- und Insomnia-Skripte.
Secret fehlt oder wird nicht gelesen
- Unaufgelöste Variable: Der Report listet Platzhalter ohne Wert unter
unresolved. Nach einem Import sind Secrets als Variablen ohne Wert angelegt – den Wert einmal in der Umgebung eintragen. - Externer Tresor (1Password, Vault, AWS, Azure, Google): Fehlt die Kommandozeile des Anbieters, die Anmeldung oder läuft die Zeit (60 Sekunden) ab, stoppt der Versand mit Exit-Code 3 und einer Meldung, was zu installieren oder welcher Anmeldebefehl auszuführen ist.
- In der Web-App liest nur der Begleitdienst externe Secrets, und nur mit
rt agent --allow-secrets. - In der Pipeline kommen Secrets als
--var NAME=WERTaus den Variablen des CI-Jobs; eine Variable mit--varwird nicht aus dem Tresor gelesen.
Commit verweigert
Vor jedem Commit prüft der Secret-Scanner die Dateien. Findet er Zugangsdaten im Klartext, verweigert die App den Commit und zeigt Datei, Zeile und Art – nie den Wert. Den Wert in eine Secret-Variable verschieben und im Request {{name}} schreiben. Ist es keine Zugangsdaten-Zeile, markiert rt-scan:allow (etwa als YAML-Kommentar) genau diese Zeile, rt-scan:allow-next-line die nächste.
Pull, Checkout und das Auflösen von Konflikten verweigern bei ungespeicherten Änderungen, damit nichts verloren geht: erst speichern, dann erneut versuchen.
OAuth 2.0 in der Pipeline
Ein Ablauf, der einen Menschen braucht (Authorization Code, Device Code), wartet sonst auf einen Browser. Mit --no-prompt scheitert er stattdessen sofort (Exit-Code 3). In der CI Client Credentials nehmen oder ein Token über --var übergeben.
KI-Agent sendet nicht
| Lage | Ursache und Lösung |
|---|---|
| Schreibender Request wird abgelehnt | Die Umgebung erlaubt nur Lesen – das ist der Standard. Im Dialog Agent access auf Read and write stellen und rt mcp neu starten (Lockern gilt erst nach einem Neustart). |
| Request hängt, dann Fehler | Er wartet auf Freigabe, weil die Umgebung als Produktion markiert ist. Im Banner der App Approve klicken oder rt approvals und rt approve <id>. Nach 300 Sekunden (--approval-timeout) scheitert er, gesendet wird nichts. |
| Umgebung fehlt in der Liste des Agenten | Sie steht auf none und ist für Agenten unsichtbar. |
| OAuth-Anmeldung startet nicht | rt mcp startet keine Anmeldung mit Browser oder Code. Einmal in der App anmelden; das Token im Schlüsselbund wird dann genutzt. |
Exit-Codes von rt send und rt run
| Code | rt send | rt run |
|---|---|---|
| 0 | Eine Antwort kam an, egal mit welchem HTTP-Status | Jeder Request bekam eine Antwort, alle Tests und Assertions bestanden |
| 1 | Keine Antwort: Verbindung, DNS, TLS, Zeitüberschreitung, zu viele Weiterleitungen | Kein Netzwerk-Stack einzurichten |
| 2 | Bedienfehler, keine Collection, ungültige Dateien, Request nicht in der Collection | Bedienfehler, unbekannte Umgebung, Datendatei unlesbar, Report nicht schreibbar |
| 3 | Request nicht vorzubereiten: unbekannte Umgebung, ungültige URL, Auth gescheitert, Plugin oder Pre-request-Skript hat gestoppt | Externe Secrets oder Plugins nicht einzurichten |
| 4 | Antwort kam, aber ein Test oder eine Assertion scheiterte | Ein Request, Test oder eine Assertion scheiterte |
Ein HTTP 404 oder 500 ist für rt send Exit-Code 0 – prüfe den Status mit einer Assertion oder mit jq.
Hilfe bekommen
Fehler und Wünsche nimmt das Repo des Kerns als Issue an, sobald es veröffentlicht ist; bis dahin über das Kontaktformular. Bitte nie Tokens, Passwörter oder Reports mit echten Secret-Werten mitschicken – die Reports von RequestTailor sind zwar maskiert, aber ein Blick vorher schadet nicht.
Siehe auch
- Doku Begleitdienst rt agent
- Doku Skripte, Tests und Runner
- Doku KI-Agenten und MCP-Server
- Doku Kommandozeile rt
- Belege rt-cli/README.md1 · rt-cli/README.md2