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ôme | Cause probable | Solution |
|---|---|---|
| « Pas d'adresse de base » signalé | Groupe sans environnement lié, ou l'environnement n'a pas la Pre-URL de ce protocole | Lier un environnement, ajouter la Pre-URL du protocole |
| WS/gRPC/MQTT ne se connecte pas | Scheme 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 pas | Host et port inversés | Le host porte l'adresse, le port est un champ séparé |
| Erreurs TLS | Scheme chiffré mais aucun certificat configuré | Importer un certificat client, ou désactiver la vérification TLS selon le besoin |
| La connexion longue tombe soudain | Ré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ôme | Cause | Solution |
|---|---|---|
| 401 même avec un token | Le 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 runtime | Utiliser 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 login | Les deux requêtes sont dans des groupes / environnements différents | Les 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ôme | Cause | Solution |
|---|---|---|
| Chinois illisible dans la réponse | Le 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 request | Une 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 scripts | Un 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ôme | Cause | Solution |
|---|---|---|
| Le script de pré-envoi a modifié le body mais le fil ne le montre pas | Pas de réécriture par « affectation » | request.body = new string (l'affectation remplace tout le body) |
| Réécriture de post-réponse invisible | Comment réécrire | response.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 mutuelles | Mécanisme de partage méconnu | Les scripts d'une même chaîne partagent globalThis — passer les valeurs via globalThis.xxx |
| AES « échec de chiffrement » dans les scripts | Forme 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ée | Copier 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.