Zum Hauptinhalt springen

Fehlerbehebung (FAQ)

Strukturiert nach „Symptom → Ursache → Lösung“. Verbindungsfehler, Auth-Fehler, Zeichensalat und unaufgelöste Variablen sind die vier großen Kategorien.

Verbindungs- / Sendefehler​

SymptomWahrscheinliche UrsacheLösung
„Keine Basisadresse“ gemeldetGruppe ohne gebundene Umgebung, oder der Umgebung fehlt die Pre-URL dieses ProtokollsUmgebung binden, Pre-URL des Protokolls ergänzen
WS/gRPC/MQTT verbindet nichtFalsches 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 nichtHost und Port vertauschtHost trägt die Adresse, der Port ist ein separates Feld
TLS-FehlerVerschlüsseltes Scheme, aber kein Zertifikat konfiguriertClient-Zertifikat importieren oder TLS-Prüfung nach Bedarf deaktivieren
Langfristige Verbindung bricht plötzlich abWird bei Inaktivität automatisch zurückgeholtVor der Nutzung neu verbinden; beim Debuggen in Serie alte Sitzungen zeitnah schließen (Kontingent ist begrenzt)

Authentifizierung (401 / 403)​

SymptomUrsacheLösung
401 trotz TokenDas 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 lesenPre-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 nichtDie beiden Requests liegen in unterschiedlichen Gruppen / UmgebungenIn dieselbe Gruppe mit derselben Umgebung legen (Laufzeitvariablen gelten pro Umgebung)

Zeichensalat / Kodierung​

SymptomUrsacheLösung
Chinesische Zeichen in der Antwort verstümmeltServer liefert kein UTF-8 (z. B. GBK)Mit passendem Charset dekodieren; über /charset/gbk reproduzieren
Entschlüsselung liefert Error: ...-StringUngü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 requestUnbehandelte 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 SkriptenEin 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​

SymptomUrsacheLösung
Pre-Send-Skript hat den Body geändert, auf der Leitung ist er nichtKeine „Zuweisungs“-Umschreibungrequest.body = new string (Zuweisung ersetzt den ganzen Body)
Post-Response-Umschreibung nicht sichtbarWie umschreiben?response.body = new string; die UI-/Ergebnisansicht zeigt nach dem Umschreiben den neuen Inhalt
Skript als „kein Einstiegspunkt, übersprungen“ gemeldetFalscher FunktionsnameMuss exakt onRequest / onResponse heißen
Skripte können einander keine Werte lesenMechanismus zum Teilen unbekanntSkripte derselben Kette teilen sich globalThis — Werte über globalThis.xxx weiterreichen
AES-„Verschlüsselung fehlgeschlagen“ in SkriptenFalsche Argumentform$crypto.encryptAES erwartet positionale Strings, kein Objekt {text,key,iv}
Skript bricht mit require: 未找到库 [...] abFalscher Bibliotheksschlüssel oder Skriptbibliothek umbenannt/gelöschtDie 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.