Feilsøking (FAQ)
Organisert som «symptom → årsak → løsning». Tilkoblingsfeil, autentiseringsfeil, kaotisk tekst og uløselige variabler er de fire store kategoriene.
Tilkoblings- / sendefeil
| Symptom | Sannsynlig årsak | Løsning |
|---|---|---|
| «No base address» rapporteres | Gruppen har ikke noe bundet miljø, eller miljøet mangler protokollens Pre-URL | Bind et miljø, legg til protokollens Pre-URL |
| WS/gRPC/MQTT kobler ikke | Feil Pre-URL-skjema (protokollen klassifiseres ut fra skjema) | ws bruker ws/wss, grpc bruker grpc/grpcs, mqtt bruker mqtt/mqtts |
| TCP/UDP kobler ikke | Vert og port byttet plass | Verten tar adressen, porten er separat |
| TLS-feil | Kryptert skjema men intet sertifikat konfigurert | Importer et klientsertifikat, eller slå av TLS-verifisering etter behov |
| Lang tilkobling bryter brått | Gjenvinnes automatisk når inaktiv | Koble til igjen før bruk; lukk gamle økter raskt ved feilsøking i batch (kvote er begrenset) |
Autentisering (401 / 403)
| Symptom | Årsak | Løsning |
|---|---|---|
| 401 selv med token | Skriptet før sending kjørte ikke (skriptkjøring deaktivert) | Bekreft at «execute scripts» er på |
{{authToken}} forblir literal (ikke erstattet) | {{}} kan ikke lese token lagret på runtime | Bruk et skript før sending med sdk.env.get for å injisere headeren (se oppskrifter, scenario 1) |
| Neste forespørsel får ikke tokenet etter innlogging | De to forespørslene er i ulike grupper / miljøer | Legg dem i samme gruppe bundet til samme miljø (kjøretidsvariabler er omfattet per miljø) |
Kaotisk tekst / Encoding
| Symptom | Årsak | Løsning |
|---|---|---|
| Kaotisk kinesisk i svaret | Serveren returnerer ikke-UTF-8 (f.eks. GBK) | Dekod med riktig charset; reproduser via /charset/gbk |
Dekryptering returnerer en Error: ...-streng | Ugyldig/tom ciphertext, eller key/iv skiller seg fra krypteringen ($crypto-feiler returnerer bare en feilstreng, kaster aldri/avbryter aldri) | Hold key og iv for kryptering/dekryptering identiske; sjekk om returnert streng starter med Error: (kinesisk klartekst round-triper fint, verifisert) |
Skriptet rapporterer Script aborted request | Ufanget JS-unntak i skriptet (vanlig: ikke-ASCII headerverdier i headers.set, eller egenskapstilgang på undefined) | Pakk risikable kall inn i try/catch; legg UTF-8-innhold i body/query-parametere og hold headerverdier ASCII |
| Merkelig base64-resultat i skript | Ga en Uint8Array/bytes til $codec/sdk.utils (blir String()-et til "97,98,99" før koding) | Send alltid strenger; både $codec.base64Encode/Decode og sdk.utils.base64Encode/Decode er UTF-8-bevisst string↔string — velg én |
Skript trer ikke i kraft
| Symptom | Årsak | Løsning |
|---|---|---|
| Skriptet før sending endret body men det vises ikke på ledningen | Ingen «tilordnings»-omskrivning | request.body = new string (tilordning erstatter hele body) |
| Omskriving etter svar usynlig | Hvordan omskrive | response.body = new string; UI/Resultatvisningen viser det nye innholdet etter omskriving |
| Skriptet rapporteres som «no entry point, skipped» | Feil funksjonsnavn | Må hete onRequest / onResponse |
| Skript kan ikke lese hverandres verdier | Ukjent med delingsmekanismen | Skript i samme kjede deler globalThis — overfør verdier via globalThis.xxx |
| AES «encryption failed» i skript | Feil argumentform | $crypto.encryptAES tar posisjonelle strenger, ikke et objekt {text,key,iv} |
Skriptet feiler med require: 未找到库 [...] | Biblioteknøkkelen er feil, eller et brukerskriptbibliotek ble omdøpt/slettet | Kopier require-setningen fra bibliotekadministratoren (identifikatorformen overlever omdøping); innebygde nøkler er @libs/base64 / @libs/hex; require i kommentarer ignoreres og bundes aldri |
Jukseark for variabeloppløsning
{{name}}: løser kun miljøkonfigurasjonsvariabler / per-send-variabler; den kan ikke lese verdier lagret under kjøring av skript.- Lese variabler inne i skript: alle tre lagene kan leses — bruk dette til tokenoverføring på tvers av forespørsler.
- For at utpakkede verdier også skal være brukbare av
{{}}: aktiver innstillingen «write extraction back to environment».
Detaljer: konsepter, variabelsystemet.
Fortsatt fastlåst?
- Få «det minimale fungerende tilfellet» i gang først med
/echo(HTTP) eller/ws/echo(WS), og legg deretter til auth/skript steg for steg. - Feilsøk ett steg av gangen: kan forespørselen komme seg ut i det hele tatt (kobler ikke → sjekk Pre-URL/vert/port) → utføres skriptene (er skriptkjøring på) → løses variablene (hvilket lag)?
- Skriptrelaterte feil kan kryssesjekkes mot Script API-referansen.