मुख्य कंटेंट तक स्किप करें

समस्या निवारण (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, वेरिएबल सिस्टम।

फिर भी अटक गए?​

  • सबसे पहले /echo (HTTP) या /ws/echo (WS) से "मिनिमल वर्किंग केस" चलाएँ, फिर क़दम-दर-क़दम auth/स्क्रिप्ट जोड़ें।
  • एक बार में एक क़दम डिबग करें: रिक्वेस्ट निकलती है या नहीं (कनेक्ट नहीं → Pre-URL/host/port देखें) → स्क्रिप्ट चलते हैं या नहीं (स्क्रिप्ट एक्ज़ीक्यूशन चालू?) → वेरिएबल रिज़ॉल्व होते हैं या नहीं (कौन-सी लेयर)?
  • स्क्रिप्ट संबंधी त्रुटियों को Script API Reference से क्रॉस-चेक किया जा सकता है।