Probleemoplossing (FAQ)
Geordend als 'symptoom → oorzaak → oplossing'. Verbindingsfouten, auth-fouten, onleesbare tekst en onopgeloste variabelen zijn de vier grote categorieën.
Verbindings- / verzendfouten
| Symptoom | Waarschijnlijke oorzaak | Oplossing |
|---|---|---|
| 'No base address' gemeld | Groep heeft geen omgeving gekoppeld, of de omgeving mist de Pre-URL van dat protocol | Koppel een omgeving, voeg de Pre-URL van het protocol toe |
| WS/gRPC/MQTT maakt geen verbinding | Pre-URL-scheme verkeerd (protocol wordt geclassificeerd op scheme) | ws gebruikt ws/wss, grpc gebruikt grpc/grpcs, mqtt gebruikt mqtt/mqtts |
| TCP/UDP maakt geen verbinding | Host en poort verwisseld | Host bevat het adres, poort staat apart |
| TLS-fouten | Versleuteld scheme maar geen certificaat ingesteld | Importeer een clientcertificaat, of zet TLS-verificatie naar behoefte uit |
| Langlopende verbinding valt plotseling weg | Wordt automatisch teruggewonnen bij inactiviteit | Verbind opnieuw voor gebruik; sluit oude sessies tijdig bij debuggen in bulk (quotum is begrensd) |
Auth (401 / 403)
| Symptoom | Oorzaak | Oplossing |
|---|---|---|
| 401 zelfs met token | Het script vóór verzending draaide niet (scriptuitvoering uitgeschakeld) | Controleer of 'scripts uitvoeren' aanstaat |
{{authToken}} blijft letterlijk (niet vervangen) | {{}} kan runtime-opgeslagen tokens niet lezen | Gebruik een script vóór verzending met sdk.env.get om de header te injecteren (zie recipes, scenario 1) |
| Volgend verzoek krijgt de token niet na het inloggen | De twee verzoeken zitten in verschillende groepen / omgevingen | Zet ze in dezelfde groep gekoppeld aan dezelfde omgeving (runtime-variabelen hebben per omgeving een eigen reikwijdte) |
Onleesbare tekst / codering
| Symptoom | Oorzaak | Oplossing |
|---|---|---|
| Onleesbare Chinese tekens in het antwoord | Server stuurt geen UTF-8 terug (bijv. GBK) | Decodeer met de juiste charset; reproduceer via /charset/gbk |
Ontsleuteling geeft een Error: ...-string terug | Ongeldig/leeg cijfertext, of key/iv wijkt af van versleuteling ($crypto-fouten geven alleen een foutstring terug, nooit throw/abort) | Houd versleutelings-/ontsleutelingskey en iv identiek; controleer of de teruggegeven string met Error: begint (Chinese platte tekst doorloopt de round-trip prima, geverifieerd) |
Script meldt Script aborted request | Een niet-gevangen JS-uitzondering in het script (vaak: niet-ASCII-headerwaarden in headers.set, of eigenschapstoegang op undefined) | Wikkel risicovolle aanroepen in try/catch; zet UTF-8-inhoud in body/query-params en houd headerwaarden ASCII |
| Vreemd base64-resultaat in scripts | Een Uint8Array/bytes meegegeven aan $codec/sdk.utils (wordt via String() eerst "97,98,99" vóór het coderen) | Geef altijd strings mee; zowel $codec.base64Encode/Decode als sdk.utils.base64Encode/Decode zijn UTF-8-bewust string↔string — kies er één |
Scripts zonder effect
| Symptoom | Oorzaak | Oplossing |
|---|---|---|
| Script vóór verzending wijzigde de body maar op de draad is het niet zichtbaar | Geen 'toewijzende' herschrijving | request.body = new string (toewijzing vervangt de hele body) |
| Herschrijving na het antwoord niet zichtbaar | Hoe herschrijven | response.body = new string; de UI-/resultaatweergave toont na herschrijven de nieuwe inhoud |
| Script gemeld als 'geen ingangspunt, overgeslagen' | Verkeerde functienaam | Moet exact onRequest / onResponse heten |
| Scripts kunnen elkaars waarden niet lezen | Onbekend met het deelmechanisme | Scripts in dezelfde keten delen globalThis — geef waarden door via globalThis.xxx |
| AES 'versleuteling mislukt' in scripts | Verkeerde argumentvorm | $crypto.encryptAES neemt positionele strings, geen object {text,key,iv} |
Script faalt met require: 未找到库 [...] | De bibliotheeksleutel klopt niet, of een scriptbibliotheek van de gebruiker is hernoemd/verwijderd | Kopieer de require-instructie vanuit de bibliotheekbeheerder (identificatorvorm overleeft hernoemingen); ingebouwde sleutels zijn @libs/base64 / @libs/hex; require in commentaar wordt genegeerd en nooit gebundeld |
Spiekbriefje variabele-resolutie
{{name}}: lost alleen omgevingsconfiguratie-variabelen / variabelen per verzending op; het kan waarden die door scripts tijdens runtime zijn opgeslagen niet lezen.- Variabelen lezen in scripts: alle drie de lagen zijn leesbaar — gebruik dit om tokens tussen verzoeken door te geven.
- Om geëxtraheerde waarden ook voor
{{}}bruikbaar te maken: zet de instelling 'extractie terugschrijven naar de omgeving' aan.
Details: concepts, het variabelensysteem.
Toch nog vastgelopen?
- Zet eerst het 'minimale werkende voorbeeld' op met
/echo(HTTP) of/ws/echo(WS), en voeg daarna auth/scripts stap voor stap toe. - Debug één stap tegelijk: verlaat het verzoek überhaupt (kan geen verbinding maken → controleer Pre-URL/host/poort) → draaien de scripts (staat scriptuitvoering aan) → worden variabelen opgelost (welke laag)?
- Scriptgerelateerde fouten kun je kruiswijs controleren met de Script-API-referentie.