समस्या निवारण (FAQ)
"लक्षण → कारण → समाधान" के रूप में व्यवस्थित। कनेक्शन विफलताएँ, प्रमाणीकरण विफलताएँ, ग़लत अक्षर और अनरिज़ॉल्व्ड वेरिएबल — चार बड़ी श्रेणियाँ।
कनेक्शन / सेंड विफलताएँ
| लक्षण | संभावित कारण | समाधान |
|---|---|---|
| "No base address" रिपोर्ट हुआ | ग्रुप में एनवायरनमेंट बंधा नहीं, या एनवायरनमेंट में उस प्रोटोकॉल का Pre-URL नहीं | एनवायरनमेंट बाइंड करें, प्रोटोकॉल का Pre-URL जोड़ें |
| WS/gRPC/MQTT कनेक्ट नहीं होते | Pre-URL स्कीम ग़लत (प्रोटोकॉल स्कीम से वर्गीकृत) | ws ws/wss, grpc grpc/grpcs, mqtt mqtt/mqtts उपयोग करता है |
| TCP/UDP कनेक्ट नहीं होते | Host और port उलटे | Host पता लेता है, port अलग है |
| TLS त्रुटियाँ | एन्क्रिप्टेड स्कीम पर सर्टिफिकेट कॉन्फ़िगर नहीं | क्लाइंट सर्टिफिकेट इंपोर्ट करें, या ज़रूरत पर TLS सत्यापन बंद करें |
| लॉंग कनेक्शन अचानक टूटता है | आइडल होने पर स्वतः वापस लिया जाता है | उपयोग से पहले फिर से कनेक्ट करें; बैच डिबगिंग में पुराने सेशन समय पर बंद करें (कोटा सीमित) |
प्रमाणीकरण (401 / 403)
| लक्षण | कारण | समाधान |
|---|---|---|
| टोकन के बावजूद 401 | प्री-सेंड स्क्रिप्ट नहीं चला (स्क्रिप्ट एक्ज़ीक्यूशन बंद) | पुष्टि करें कि "execute scripts" चालू है |
{{authToken}} शाब्दिक रहता है (बदलता नहीं) | {{}} रनटाइम में सेव टोकन नहीं पढ़ सकता | sdk.env.get के साथ प्री-सेंड स्क्रिप्ट से हेडर इंजेक्ट करें (देखें recipes, परिदृश्य 1) |
| लॉगिन के बाद अगली रिक्वेस्ट को टोकन नहीं मिलता | दोनों रिक्वेस्ट अलग ग्रुप / एनवायरनमेंट में | दोनों को उसी एनवायरनमेंट से बंधी ग्रुप में डालें (रनटाइम वेरिएबल का स्कोप प्रति एनवायरनमेंट) |
ग़लत अक्षर / एनकोडिंग
| लक्षण | कारण | समाधान |
|---|---|---|
| रिस्पॉन्स में ग़लत अक्षर | सर्वर ग़ैर-UTF-8 (जैसे GBK) लौटाता है | मिलते-जुलते चारसेट से डिकोड करें; /charset/gbk से पुनः उत्पन्न करें |
डिक्रिप्शन Error: ... स्ट्रिंग लौटाता है | अमान्य/खाली साइफ़रटेक्स्ट, या key/iv एन्क्रिप्शन से अलग ($crypto केवल त्रुटि स्ट्रिंग लौटाता है, कभी थ्रो/एबॉर्ट नहीं) | एन्क्रिप्शन/डिक्रिप्शन का key और iv समान रखें; देखें स्ट्रिंग Error: से शुरू होती है या नहीं (प्लेनटेक्स्ट का राउंड-ट्रिप ठीक चलता है, सत्यापित) |
स्क्रिप्ट Script aborted request रिपोर्ट करता है | स्क्रिप्ट में अनकॉट JS अपवाद (आम: headers.set में ग़ैर-ASCII हेडर मान, या undefined पर प्रॉपर्टी एक्सेस) | जोखिम भरे कॉल try/catch में लपेटें; UTF-8 कंटेंट body/query params में रखें और हेडर मान ASCII रखें |
| स्क्रिप्ट में अजीब base64 परिणाम | $codec/sdk.utils को Uint8Array/बाइट्स पास किया (एनकोड से पहले String()-ed होकर "97,98,99" बन जाता है) | हमेशा स्ट्रिंग पास करें; $codec.base64Encode/Decode और sdk.utils.base64Encode/Decode दोनों UTF-8-जागरूक स्ट्रिंग↔स्ट्रिंग हैं — एक चुनें |
स्क्रिप्ट असर नहीं कर रहे
| लक्षण | कारण | समाधान |
|---|---|---|
| प्री-सेंड स्क्रिप्ट ने body बदला पर वायर पर नहीं दिखता | कोई "असाइनमेंट" रीराइट नहीं | request.body = new string (असाइनमेंट पूरे body को बदलता है) |
| पोस्ट-रिस्पॉन्स रीराइट नहीं दिखता | कैसे रीराइट करें | response.body = new string; UI/परिणाम व्यू रीराइट के बाद नया कंटेंट दिखाता है |
| स्क्रिप्ट "no entry point, skipped" बताई गई | फ़ंक्शन नाम ग़लत | नाम onRequest / onResponse होना चाहिए |
| स्क्रिप्ट एक-दूसरे के मान नहीं पढ़ पाते | शेयरिंग तंत्र से अनभिज्ञ | एक ही चेन के स्क्रिप्ट globalThis शेयर करते हैं — मान globalThis.xxx से पास करें |
| स्क्रिप्ट में AES "encryption failed" | आर्गुमेंट शेप ग़लत | $crypto.encryptAES पोज़िशनल स्ट्रिंग लेता है, ऑब्जेक्ट {text,key,iv} नहीं |
स्क्रिप्ट require: 未找到库 [...] के साथ फ़ेल | लाइब्रेरी की ग़लत, या यूज़र स्क्रिप्ट लाइब्रेरी रिनेम/डिलीट हुई | लाइब्रेरी मैनेजर से require स्टेटमेंट कॉपी करें (आइडेंटिफ़ायर फ़ॉर्म रिनेम से बच जाता है); बिल्ट-इन कीज़ @libs/base64 / @libs/hex; कमेंट में require अनदेखा और कभी बंडल नहीं |
वेरिएबल रिज़ॉल्यूशन चीट शीट
{{name}}: केवल एनवायरनमेंट कॉन्फ़िगरेशन वेरिएबल / पर-सेंड वेरिएबल रिज़ॉल्व करता है; स्क्रिप्ट्स द्वारा रनटाइम पर सेव मान नहीं पढ़ सकता।- स्क्रिप्ट के अंदर वेरिएबल पढ़ना: तीनों लेयर पढ़ी जा सकती हैं — इसे क्रॉस-रिक्वेस्ट टोकन पासिंग के लिए उपयोग करें।
- एक्सट्रैक्ट किए मानों को
{{}}के लिए भी उपयोगी बनाने के लिए: "एक्सट्रैक्शन को एनवायरनमेंट में वापस लिखें" सेटिंग चालू करें।
विवरण: concepts, वेरिएबल सिस्टम।