Passa al contenuto principale

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​

SintomoCausa probabileSoluzione
Segnalato «nessun indirizzo base»Il gruppo non ha un ambiente associato, o all'ambiente manca il Pre-URL di quel protocolloAssocia un ambiente, aggiungi il Pre-URL del protocollo
WS/gRPC/MQTT non si connettonoSchema 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 connettonoHost e porta invertitiHost prende l'indirizzo, la porta è separata
Errori TLSSchema cifrato ma nessun certificato configuratoImporta un certificato client, o disattiva la verifica TLS secondo necessità
La connessione lunga cade improvvisamenteRitratta automaticamente quando inattivaRiconnetti prima dell'uso; chiudi prontamente le vecchie sessioni quando fai debugging in batch (la quota è limitata)

Autenticazione (401 / 403)​

SintomoCausaSoluzione
401 anche con un tokenLo 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 runtimeUsa 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 loginLe due richieste sono in gruppi / ambienti diversiMettile nello stesso gruppo associato allo stesso ambiente (le variabili di runtime hanno ambito per ambiente)

Testo illeggibile / codifica​

SintomoCausaSoluzione
Caratteri cinesi illeggibili nella rispostaIl 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 requestUn'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 scriptPassato 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​

SintomoCausaSoluzione
Lo script di pre-invio ha cambiato il body ma sul filo non si vedeNessuna riscrittura per «assegnazione»request.body = new string (l'assegnazione sostituisce tutto il body)
Riscrittura post-risposta invisibileCome riscrivereresponse.body = new string; la vista UI/risultato mostra il nuovo contenuto dopo la riscrittura
Script riportato come «nessun punto di ingresso, saltato»Nome funzione sbagliatoDeve chiamarsi onRequest / onResponse
Gli script non leggono i valori degli altriNon si conosce il meccanismo di condivisioneGli script nella stessa catena condividono globalThis — passa i valori via globalThis.xxx
«Crittazione fallita» AES negli scriptForma 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/eliminataCopia 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.