Fehlerbehebung (FAQ)
Strukturiert nach „Symptom → Ursache → Lösung“. Verbindungsfehler, Auth-Fehler, Zeichensalat und unaufgelöste Variablen sind die vier großen Kategorien.
Verbindungs- / Sendefehler
| Symptom | Wahrscheinliche Ursache | Lösung |
|---|---|---|
| „Keine Basisadresse“ gemeldet | Gruppe ohne gebundene Umgebung, oder der Umgebung fehlt die Pre-URL dieses Protokolls | Umgebung binden, Pre-URL des Protokolls ergänzen |
| WS/gRPC/MQTT verbindet nicht | Falsches Pre-URL-Scheme (das Protokoll richtet sich nach dem Scheme) | ws nutzt ws/wss, grpc nutzt grpc/grpcs, mqtt nutzt mqtt/mqtts |
| TCP/UDP verbindet nicht | Host und Port vertauscht | Host trägt die Adresse, der Port ist ein separates Feld |
| TLS-Fehler | Verschlüsseltes Scheme, aber kein Zertifikat konfiguriert | Client-Zertifikat importieren oder TLS-Prüfung nach Bedarf deaktivieren |
| Langfristige Verbindung bricht plötzlich ab | Wird bei Inaktivität automatisch zurückgeholt | Vor der Nutzung neu verbinden; beim Debuggen in Serie alte Sitzungen zeitnah schließen (Kontingent ist begrenzt) |
Authentifizierung (401 / 403)
| Symptom | Ursache | Lösung |
|---|---|---|
| 401 trotz Token | Das Pre-Send-Skript ist nicht gelaufen (Skriptausführung deaktiviert) | Prüfen, dass „Skripte ausführen“ aktiviert ist |
{{authToken}} bleibt wörtlich stehen (nicht ersetzt) | {{}} kann zur Laufzeit gespeicherte Tokens nicht lesen | Pre-Send-Skript mit sdk.env.get nutzen, um den Header zu injizieren (siehe Rezepte, Szenario 1) |
| Nächster Request erhält den Token nach dem Login nicht | Die beiden Requests liegen in unterschiedlichen Gruppen / Umgebungen | In dieselbe Gruppe mit derselben Umgebung legen (Laufzeitvariablen gelten pro Umgebung) |
Zeichensalat / Kodierung
| Symptom | Ursache | Lösung |
|---|---|---|
| Chinesische Zeichen in der Antwort verstümmelt | Server liefert kein UTF-8 (z. B. GBK) | Mit passendem Charset dekodieren; über /charset/gbk reproduzieren |
Entschlüsselung liefert Error: ...-String | Ungültiger/leerer Ciphertext oder Schlüssel/IV weicht von der Verschlüsselung ab ($crypto liefert nur Fehler-Strings, wirft nie/bricht nie ab) | Schlüssel & IV von Ver- und Entschlüsselung identisch halten; prüfen, ob der Rückgabestring mit Error: beginnt (chinesischer Klartext läuft sauber durch, verifiziert) |
Skript meldet Script aborted request | Unbehandelte JS-Exception im Skript (häufig: Nicht-ASCII-Headerwerte in headers.set oder Eigenschaftszugriff auf undefined) | Riskante Aufrufe in try/catch packen; UTF-8-Inhalte in Body/Query-Params, Headerwerte ASCII halten |
| Seltsames Base64-Ergebnis in Skripten | Ein Uint8Array/Bytes an $codec/sdk.utils übergeben (wird vor dem Encoden per String() zu "97,98,99") | Immer Strings übergeben; $codec.base64Encode/Decode und sdk.utils.base64Encode/Decode sind UTF-8-sicher string↔string — eines auswählen |
Skripte greifen nicht
| Symptom | Ursache | Lösung |
|---|---|---|
| Pre-Send-Skript hat den Body geändert, auf der Leitung ist er nicht | Keine „Zuweisungs“-Umschreibung | request.body = new string (Zuweisung ersetzt den ganzen Body) |
| Post-Response-Umschreibung nicht sichtbar | Wie umschreiben? | response.body = new string; die UI-/Ergebnisansicht zeigt nach dem Umschreiben den neuen Inhalt |
| Skript als „kein Einstiegspunkt, übersprungen“ gemeldet | Falscher Funktionsname | Muss exakt onRequest / onResponse heißen |
| Skripte können einander keine Werte lesen | Mechanismus zum Teilen unbekannt | Skripte derselben Kette teilen sich globalThis — Werte über globalThis.xxx weiterreichen |
| AES-„Verschlüsselung fehlgeschlagen“ in Skripten | Falsche Argumentform | $crypto.encryptAES erwartet positionale Strings, kein Objekt {text,key,iv} |
Skript bricht mit require: 未找到库 [...] ab | Falscher Bibliotheksschlüssel oder Skriptbibliothek umbenannt/gelöscht | Die require-Anweisung aus dem Bibliotheksmanager kopieren (Identifier-Form überlebt Umbenennungen); eingebaute Schlüssel sind @libs/base64 / @libs/hex; require in Kommentaren wird ignoriert und nie gebündelt |
Variablen-Kurzreferenz
{{name}}: löst nur Umgebungskonfigurations- / Sendevariablen auf; zur Laufzeit von Skripten gespeicherte Werte sind nicht lesbar.- Variablen in Skripten lesen: alle drei Ebenen sind lesbar — dafür ist der Token-Transfer über Requests gedacht.
- Damit extrahierte Werte auch für
{{}}nutzbar sind: die Einstellung „Extraktion in die Umgebung zurückschreiben“ aktivieren.
Details: Kernkonzepte, das Variablensystem.
Immer noch festhängend?
- Bringen Sie zuerst den „minimal funktionierenden Fall“ mit
/echo(HTTP) bzw./ws/echo(WS) zum Laufen und bauen Sie dann Schritt für Schritt Auth/Skripte dazu. - Debuggen Sie einen Schritt nach dem anderen: Verlässt die Anfrage überhaupt das Gerät (keine Verbindung → Pre-URL/Host/Port prüfen) → laufen die Skripte (ist die Skriptausführung an) → lösen die Variablen auf (welche Ebene)?
- Skriptbezogene Fehler lassen sich mit der Script-API-Referenz gegenprüfen.