Aller au contenu principal

Dépannage (FAQ)

Organisé en « symptôme → cause → solution ». Les échecs de connexion, les échecs d'authentification, le texte illisible et les variables non résolues sont les quatre grandes catégories.

Échecs de connexion / d'envoi​

SymptômeCause probableSolution
« Pas d'adresse de base » signaléGroupe sans environnement lié, ou l'environnement n'a pas la Pre-URL de ce protocoleLier un environnement, ajouter la Pre-URL du protocole
WS/gRPC/MQTT ne se connecte pasScheme de Pre-URL erroné (le protocole se classe selon le scheme)ws utilise ws/wss, grpc utilise grpc/grpcs, mqtt utilise mqtt/mqtts
TCP/UDP ne se connecte pasHost et port inversésLe host porte l'adresse, le port est un champ séparé
Erreurs TLSScheme chiffré mais aucun certificat configuréImporter un certificat client, ou désactiver la vérification TLS selon le besoin
La connexion longue tombe soudainRécupérée automatiquement à l'inactivitéSe reconnecter avant usage ; fermer rapidement les anciennes sessions en débogage en série (le quota est limité)

Authentification (401 / 403)​

SymptômeCauseSolution
401 même avec un tokenLe script de pré-envoi n'a pas tourné (exécution des scripts désactivée)Vérifier que « exécuter les scripts » est activé
{{authToken}} reste littéral (non remplacé){{}} ne peut pas lire les tokens stockés au runtimeUtiliser un script de pré-envoi avec sdk.env.get pour injecter le header (voir recettes, scénario 1)
La requête suivante n'obtient pas le token après le loginLes deux requêtes sont dans des groupes / environnements différentsLes mettre dans le même groupe lié au même environnement (les variables d'exécution ont une portée par environnement)

Texte illisible / Encodage​

SymptômeCauseSolution
Chinois illisible dans la réponseLe serveur renvoie du non-UTF-8 (ex. GBK)Décoder avec le charset correspondant ; reproduire via /charset/gbk
Le déchiffrement renvoie une chaîne Error: ...Ciphertext invalide/vide, ou clé/iv différents du chiffrement (les échecs $crypto ne renvoient qu'une chaîne d'erreur, ne lancent jamais)Garder clé & iv identiques au chiffrement/déchiffrement ; vérifier si la chaîne retournée commence par Error: (le plaintext chinois fait l'aller-retour, vérifié)
Le script signale Script aborted requestUne exception JS non interceptée dans le script (courant : valeurs de header non ASCII dans headers.set, ou accès à une propriété sur undefined)Encadrer les appels risqués de try/catch ; mettre le contenu UTF-8 dans le body/query params et garder les valeurs de header en ASCII
Résultat base64 bizarre dans les scriptsUn Uint8Array/des bytes passé à $codec/sdk.utils (converti en String() → "97,98,99" avant encodage)Toujours passer des chaînes ; $codec.base64Encode/Decode et sdk.utils.base64Encode/Decode sont string↔string UTF-8 — en choisir une

Les scripts ne prennent pas effet​

SymptômeCauseSolution
Le script de pré-envoi a modifié le body mais le fil ne le montre pasPas de réécriture par « affectation »request.body = new string (l'affectation remplace tout le body)
Réécriture de post-réponse invisibleComment réécrireresponse.body = new string ; la vue interface/résultat montre le nouveau contenu après réécriture
Script signalé « sans point d'entrée, ignoré »Nom de fonction erronéDoit s'appeler onRequest / onResponse
Les scripts ne lisent pas leurs valeurs mutuellesMécanisme de partage méconnuLes scripts d'une même chaîne partagent globalThis — passer les valeurs via globalThis.xxx
AES « échec de chiffrement » dans les scriptsForme d'arguments erronée$crypto.encryptAES prend des chaînes positionnelles, pas un objet {text,key,iv}
Échec du script avec require: 未找到库 [...]Clé de bibliothèque erronée, ou bibliothèque renommée/suppriméeCopier l'instruction require depuis le gestionnaire de bibliothèques (la forme identifiant survit aux renommages) ; les clés intégrées sont @libs/base64 / @libs/hex ; require dans les commentaires est ignoré et n'est jamais bundlé

Aide-mémoire de résolution des variables​

  • {{name}} : ne résout que les variables de configuration d'environnement / variables par envoi ; il ne peut pas lire les valeurs stockées au runtime par les scripts.
  • Lecture des variables dans les scripts : les trois couches sont lisibles — à utiliser pour le passage de tokens entre requêtes.
  • Pour rendre les valeurs extraites lisibles aussi par {{}} : activer le réglage « réécrire l'extraction vers l'environnement ».

Détails : concepts, le système de variables.

Toujours bloqué ?​

  • Faites d'abord tourner le « cas minimal fonctionnel » avec /echo (HTTP) ou /ws/echo (WS), puis ajoutez auth/scripts pas à pas.
  • Déboguez une étape à la fois : la requête part-elle du tout (pas de connexion → vérifier Pre-URL/host/port) → les scripts s'exécutent-ils (l'exécution des scripts est-elle active) → les variables se résolvent-elles (quelle couche) ?
  • Les erreurs liées aux scripts peuvent être recoupées avec la Référence de l'API de scripts.