Ga naar hoofdinhoud

Probleemoplossing (FAQ)

Geordend als 'symptoom → oorzaak → oplossing'. Verbindingsfouten, auth-fouten, onleesbare tekst en onopgeloste variabelen zijn de vier grote categorieën.

Verbindings- / verzendfouten​

SymptoomWaarschijnlijke oorzaakOplossing
'No base address' gemeldGroep heeft geen omgeving gekoppeld, of de omgeving mist de Pre-URL van dat protocolKoppel een omgeving, voeg de Pre-URL van het protocol toe
WS/gRPC/MQTT maakt geen verbindingPre-URL-scheme verkeerd (protocol wordt geclassificeerd op scheme)ws gebruikt ws/wss, grpc gebruikt grpc/grpcs, mqtt gebruikt mqtt/mqtts
TCP/UDP maakt geen verbindingHost en poort verwisseldHost bevat het adres, poort staat apart
TLS-foutenVersleuteld scheme maar geen certificaat ingesteldImporteer een clientcertificaat, of zet TLS-verificatie naar behoefte uit
Langlopende verbinding valt plotseling wegWordt automatisch teruggewonnen bij inactiviteitVerbind opnieuw voor gebruik; sluit oude sessies tijdig bij debuggen in bulk (quotum is begrensd)

Auth (401 / 403)​

SymptoomOorzaakOplossing
401 zelfs met tokenHet script vóór verzending draaide niet (scriptuitvoering uitgeschakeld)Controleer of 'scripts uitvoeren' aanstaat
{{authToken}} blijft letterlijk (niet vervangen){{}} kan runtime-opgeslagen tokens niet lezenGebruik 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 inloggenDe twee verzoeken zitten in verschillende groepen / omgevingenZet ze in dezelfde groep gekoppeld aan dezelfde omgeving (runtime-variabelen hebben per omgeving een eigen reikwijdte)

Onleesbare tekst / codering​

SymptoomOorzaakOplossing
Onleesbare Chinese tekens in het antwoordServer stuurt geen UTF-8 terug (bijv. GBK)Decodeer met de juiste charset; reproduceer via /charset/gbk
Ontsleuteling geeft een Error: ...-string terugOngeldig/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 requestEen 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 scriptsEen 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​

SymptoomOorzaakOplossing
Script vóór verzending wijzigde de body maar op de draad is het niet zichtbaarGeen 'toewijzende' herschrijvingrequest.body = new string (toewijzing vervangt de hele body)
Herschrijving na het antwoord niet zichtbaarHoe herschrijvenresponse.body = new string; de UI-/resultaatweergave toont na herschrijven de nieuwe inhoud
Script gemeld als 'geen ingangspunt, overgeslagen'Verkeerde functienaamMoet exact onRequest / onResponse heten
Scripts kunnen elkaars waarden niet lezenOnbekend met het deelmechanismeScripts in dezelfde keten delen globalThis — geef waarden door via globalThis.xxx
AES 'versleuteling mislukt' in scriptsVerkeerde 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/verwijderdKopieer 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.