Усунення несправностей (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.