Перейти к основному содержимому

Устранение неполадок (FAQ)

Организовано как «симптом → причина → исправление». Ошибки соединения, ошибки аутентификации, кракозябры и неразрешенные переменные — четыре большие категории.

Ошибки соединения / отправки​

СимптомВероятная причинаИсправление
«Нет базового адреса»К группе не привязано окружение, либо в окружении нет Pre-URL этого протоколаПривяжите окружение, добавьте Pre-URL протокола
WS/gRPC/MQTT не подключаютсяНеверная схема Pre-URL (протокол классифицируется по схеме)ws использует ws/wss, grpc — grpc/grpcs, mqtt — mqtt/mqtts
TCP/UDP не подключаютсяХост и порт перепутаныВ хост идет адрес, порт хранится отдельно
Ошибки TLSШифрованная схема, но не настроен сертификатИмпортируйте клиентский сертификат или при необходимости отключите проверку TLS
Долгое соединение внезапно рветсяАвтоматически освобождается при простоеПереподключайтесь перед использованием; при отладке партиями своевременно закрывайте старые сессии (квота ограничена)

Аутентификация (401 / 403)​

СимптомПричинаИсправление
401 даже с токеномСкрипт перед отправкой не выполнился (выполнение скриптов отключено)Убедитесь, что «выполнять скрипты» включено
{{authToken}} остается литералом (не заменяется){{}} не читает токены, сохраненные в runtimeИспользуйте скрипт перед отправкой с sdk.env.get, чтобы вставить заголовок (см. recipes, сценарий 1)
Следующий запрос не получает токен после входаДва запроса в разных группах / окруженияхПоместите их в одну группу с одним окружением (runtime-переменные ограничены окружением)

Кракозябры / кодировка​

СимптомПричинаИсправление
Кракозябры вместо китайского в ответеСервер возвращает не UTF-8 (например GBK)Декодируйте соответствующей кодировкой; воспроизведите через /charset/gbk
Расшифровка возвращает строку Error: ...Неверный/пустой шифротекст или key/iv не совпадают с шифрованием ($crypto при сбое только возвращает строку ошибки, не бросает исключение и не прерывает)Держите key и iv шифрования/расшифровки одинаковыми; проверьте, начинается ли возвращенная строка с Error: (китайский текст проходит цикл корректно, проверено)
Скрипт сообщает Script aborted requestНеперехваченное исключение JS в скрипте (частые случаи: не-ASCII значения в headers.set или обращение к свойству undefined)Оборачивайте рискованные вызовы в try/catch; UTF-8-контент кладите в body/query-параметры, а значения заголовков держите ASCII
Странный результат base64 в скриптахВ $codec/sdk.utils передан Uint8Array/байты (будет превращен String()-ом в "97,98,99" перед кодированием)Всегда передавайте строки; и $codec.base64Encode/Decode, и sdk.utils.base64Encode/Decode — UTF-8-безопасные строка↔строка — выберите одну

Скрипты не применяются​

СимптомПричинаИсправление
Скрипт перед отправкой изменил body, но на проводе этого нетНет переписывания «присваиванием»request.body = new string (присваивание заменяет весь body)
Переписывание после ответа незаметноКак переписатьresponse.body = new string; UI/просмотр результата показывает новый контент после переписывания
Скрипт помечен «нет точки входа, пропущен»Неверное имя функцииДолжно быть onRequest / onResponse
Скрипты не видят значения друг другаНезнание механизма совместного доступаСкрипты одной цепочки разделяют globalThis — передавайте значения через globalThis.xxx
AES «ошибка шифрования» в скриптахНеверная форма аргументов$crypto.encryptAES принимает позиционные строки, а не объект {text,key,iv}
Ошибка скрипта require: 未找到库 [...]Неверный ключ библиотеки или пользовательская библиотека переименована/удаленаСкопируйте require-строку из менеджера библиотек (форма идентификатора переживает переименования); встроенные ключи — @libs/base64 / @libs/hex; require в комментариях игнорируется и никогда не связывается

Шпаргалка по разрешению переменных​

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

Подробнее: concepts, система переменных.

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

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