Перейти до основного вмісту

Усунення несправностей (FAQ)

Організовано за схемою «симптом → причина → виправлення». Невдачі з'єднання, невдачі автентифікації, кракозябри та нерозв'язані змінні — чотири великі категорії.

Помилки з'єднання / відправки​

СимптомЙмовірна причинаВиправлення
«Немає базової адреси»Група не прив'язана до середовища, або в середовищі немає 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: (текст у UTF-8 проходить туди-назад, перевірено)
Скрипт повідомляє Script aborted requestНеперехоплений виняток JS у скрипті (часто: не-ASCII значення заголовків у headers.set або доступ до властивості undefined)Обгорніть ризиковані виклики в try/catch; кладіть UTF-8 у body/query params, а значення заголовків тримайте ASCII
Дивний результат base64 у скриптахПередано Uint8Array/байти в $codec/sdk.utils (перетворюється через String() на "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 «помилка шифрування» у скриптахНеправильна форма аргументів$crypto.encryptAES приймає позиційні рядки, а не об'єкт {text,key,iv}
Скрипт падає з require: 未找到库 [...]Неправильний ключ бібліотеки, або бібліотеку користувача перейменовано/видаленоСкопіюйте require-вираз із менеджера бібліотек (форма з ідентифікатором переживає перейменування); вбудовані ключі — @libs/base64 / @libs/hex; require у коментарях ігнорується і ніколи не пакується

Шпаргалка з розв'язання змінних​

  • {{name}}: резолвить лише конфігураційні змінні середовища / змінні окремої відправки; не може читати значення, збережені скриптами в часі виконання.
  • Читання змінних усередині скриптів: доступні всі три шари — використовуйте це для передавання токенів між запитами.
  • Щоб витягнуті значення були доступні й для {{}}: увімкніть налаштування «записувати витягування назад у середовище».

Деталі: concepts, система змінних.

Все ще застрягли?​

  • Спочатку запустіть «мінімальний робочий випадок» через /echo (HTTP) або /ws/echo (WS), а потім крок за кроком додавайте автентифікацію/скрипти.
  • Налагоджуйте по одному кроку: чи взагалі виходить запит (не з'єднується → перевірте Pre-URL/host/port) → чи виконуються скрипти (чи ввімкнено виконання скриптів) → чи резолвляться змінні (який шар)?
  • Помилки, пов'язані зі скриптами, можна звірити з Довідником Script API.