Risoluzione dei problemi (FAQ)
Organizzata come «sintomo → causa → soluzione». Fallimenti di connessione, fallimenti di autenticazione, testo illeggibile e variabili non risolte sono le quattro grandi categorie.
Fallimenti di connessione / invio
| Sintomo | Causa probabile | Soluzione |
|---|---|---|
| Segnalato «nessun indirizzo base» | Il gruppo non ha un ambiente associato, o all'ambiente manca il Pre-URL di quel protocollo | Associa un ambiente, aggiungi il Pre-URL del protocollo |
| WS/gRPC/MQTT non si connettono | Schema del Pre-URL sbagliato (il protocollo è classificato dallo schema) | ws usa ws/wss, grpc usa grpc/grpcs, mqtt usa mqtt/mqtts |
| TCP/UDP non si connettono | Host e porta invertiti | Host prende l'indirizzo, la porta è separata |
| Errori TLS | Schema cifrato ma nessun certificato configurato | Importa un certificato client, o disattiva la verifica TLS secondo necessità |
| La connessione lunga cade improvvisamente | Ritratta automaticamente quando inattiva | Riconnetti prima dell'uso; chiudi prontamente le vecchie sessioni quando fai debugging in batch (la quota è limitata) |
Autenticazione (401 / 403)
| Sintomo | Causa | Soluzione |
|---|---|---|
| 401 anche con un token | Lo script di pre-invio non è stato eseguito (esecuzione script disattivata) | Conferma che «esegui script» sia attivo |
{{authToken}} resta letterale (non sostituito) | {{}} non può leggere i token memorizzati a runtime | Usa uno script di pre-invio con sdk.env.get per iniettare l'header (vedi recipes, scenario 1) |
| La richiesta successiva non ottiene il token dopo il login | Le due richieste sono in gruppi / ambienti diversi | Mettile nello stesso gruppo associato allo stesso ambiente (le variabili di runtime hanno ambito per ambiente) |
Testo illeggibile / codifica
| Sintomo | Causa | Soluzione |
|---|---|---|
| Caratteri cinesi illeggibili nella risposta | Il server restituisce non-UTF-8 (es. GBK) | Decodifica con il charset corrispondente; riproduci via /charset/gbk |
La decrittazione restituisce una stringa Error: ... | Ciphertext non valido/vuoto, o key/iv diversi dalla crittografia (i fallimenti di $crypto restituiscono solo una stringa di errore, mai throw/abort) | Mantieni key & iv di crittazione/decrittazione identici; controlla se la stringa restituita inizia con Error: (il plaintext cinese fa il round-trip bene, verificato) |
Lo script riporta Script aborted request | Un'eccezione JS non catturata nello script (comune: valori header non ASCII in headers.set, o accesso a proprietà su undefined) | Avvolgi le chiamate a rischio in try/catch; metti il contenuto UTF-8 in body/query params e tieni i valori header ASCII |
| Risultato base64 strano negli script | Passato un Uint8Array/byte a $codec/sdk.utils (viene String()-ato in "97,98,99" prima della codifica) | Passa sempre stringhe; sia $codec.base64Encode/Decode che sdk.utils.base64Encode/Decode sono stringa↔stringa consapevoli di UTF-8 — scegline uno |
Script che non hanno effetto
| Sintomo | Causa | Soluzione |
|---|---|---|
| Lo script di pre-invio ha cambiato il body ma sul filo non si vede | Nessuna riscrittura per «assegnazione» | request.body = new string (l'assegnazione sostituisce tutto il body) |
| Riscrittura post-risposta invisibile | Come riscrivere | response.body = new string; la vista UI/risultato mostra il nuovo contenuto dopo la riscrittura |
| Script riportato come «nessun punto di ingresso, saltato» | Nome funzione sbagliato | Deve chiamarsi onRequest / onResponse |
| Gli script non leggono i valori degli altri | Non si conosce il meccanismo di condivisione | Gli script nella stessa catena condividono globalThis — passa i valori via globalThis.xxx |
| «Crittazione fallita» AES negli script | Forma degli argomenti sbagliata | $crypto.encryptAES prende stringhe posizionali, non un oggetto {text,key,iv} |
Lo script fallisce con require: 未找到库 [...] | La chiave della libreria è sbagliata, o una libreria utente è stata rinominata/eliminata | Copia l'istruzione require dal gestore librerie (la forma identificatore sopravvive ai rinomina); le chiavi integrate sono @libs/base64 / @libs/hex; il require nei commenti è ignorato e non fa mai bundle |
Promemoria risoluzione variabili
{{name}}: risolve solo variabili di configurazione d'ambiente / variabili per invio; non può leggere i valori memorizzati a runtime dagli script.- Leggere variabili dentro gli script: tutti e tre i livelli sono leggibili — usalo per il passaggio di token tra richieste.
- Per rendere i valori estratti utilizzabili anche da
{{}}: attiva l'impostazione «riscrivi l'estrazione nell'ambiente».
Dettagli: concepts, il sistema di variabili.
Ancora bloccato?
- Fai girare prima il «caso minimo funzionante» con
/echo(HTTP) o/ws/echo(WS), poi aggiungi auth/script passo per passo. - Esegui il debug un passo alla volta: la richiesta può proprio partire (non si connette → controlla Pre-URL/host/porta) → gli script si eseguono (l'esecuzione script è attiva?) → le variabili si risolvono (quale livello)?
- Gli errori legati agli script si possono verificare incrociatamente con il Riferimento API degli script.