Rozwiązywanie problemów (FAQ)
Uporządkowane według schematu „objaw → przyczyna → rozwiązanie”. Błędy połączenia, błędy autoryzacji, nieczytelne znaki i nierozwiązywane zmienne to cztery główne kategorie.
Błędy połączenia / wysyłki
| Objaw | Prawdopodobna przyczyna | Rozwiązanie |
|---|---|---|
| Komunikat „No base address” | Grupa nie ma powiązanego środowiska albo środowisku brakuje Pre-URL tego protokołu | Powiąż środowisko, dodaj Pre-URL protokołu |
| WS/gRPC/MQTT nie łączy się | Zły schemat Pre-URL (protokół jest klasyfikowany po schemacie) | ws używa ws/wss, grpc używa grpc/grpcs, mqtt używa mqtt/mqtts |
| TCP/UDP nie łączy się | Zamienione host i port | Host przechowuje adres, port jest osobno |
| Błędy TLS | Schemat szyfrowany, ale brak skonfigurowanego certyfikatu | Zaimportuj certyfikat klienta albo wyłącz weryfikację TLS w razie potrzeby |
| Długotrwałe połączenie nagle znika | Odzyskiwane automatycznie przy bezczynności | Połącz się ponownie przed użyciem; zamykaj stare sesje od razu przy debugowaniu partiami (limit jest ograniczony) |
Autoryzacja (401 / 403)
| Objaw | Przyczyna | Rozwiązanie |
|---|---|---|
| 401 nawet z tokenem | Skrypt przed wysłaniem się nie wykonał (wykonywanie skryptów wyłączone) | Sprawdź, czy „wykonywanie skryptów” jest włączone |
{{authToken}} zostaje literalny (bez podmiany) | {{}} nie potrafi odczytać tokenów zapisanych w runtime | Użyj skryptu przed wysłaniem z sdk.env.get, żeby wstrzyknąć nagłówek (zobacz recipes, scenariusz 1) |
| Następne żądanie nie dostaje tokena po logowaniu | Oba żądania są w różnych grupach / środowiskach | Umieść je w tej samej grupie powiązanej z tym samym środowiskiem (zmienne uruchomieniowe mają zasięg per środowisko) |
Nieczytelne znaki / kodowanie
| Objaw | Przyczyna | Rozwiązanie |
|---|---|---|
| Nieczytelne znaki chińskie w odpowiedzi | Serwer nie zwraca UTF-8 (np. GBK) | Dekoduj pasującym charsetem; odtwórz przez /charset/gbk |
Deszyfrowanie zwraca string Error: ... | Nieprawidłowy/pusty szyfrogram albo key/iv różni się od szyfrowania (błędy $crypto zwracają tylko string błędu, nigdy nie rzucają/abortują) | Trzymaj klucz i iv szyfrowania/deszyfrowania identyczne; sprawdź, czy zwrócony string zaczyna się od Error: (chiński plaintext przechodzi round-trip bez problemu, zweryfikowano) |
Skrypt zgłasza Script aborted request | Nieprzechwycony wyjątek JS w skrypcie (często: nie-ASCII wartości nagłówków w headers.set albo dostęp do właściwości na undefined) | Owiń ryzykowne wywołania w try/catch; treść UTF-8 umieszczaj w body/query-params i trzymaj wartości nagłówków ASCII |
| Dziwny wynik base64 w skryptach | Przekazano Uint8Array/bajty do $codec/sdk.utils (przed kodowaniem przechodzi przez String(), dając "97,98,99") | Zawsze przekazuj stringi; zarówno $codec.base64Encode/Decode, jak i sdk.utils.base64Encode/Decode są świadome UTF-8 string↔string — wybierz jedno |
Skrypty nie działają
| Objaw | Przyczyna | Rozwiązanie |
|---|---|---|
| Skrypt przed wysłaniem zmienił body, ale na drucie tego nie widać | Brak przepisania „przypisaniem” | request.body = new string (przypisanie zastępuje cały body) |
| Przepisanie po odpowiedzi niewidoczne | Jak przepisywać | response.body = new string; widok UI/wynik pokazuje nową treść po przepisaniu |
| Skrypt zgłoszony jako „brak punktu wejścia, pominięto” | Zła nazwa funkcji | Musi nazywać się dokładnie onRequest / onResponse |
| Skrypty nie mogą czytać wartości nawzajem | Nieznajomość mechanizmu współdzielenia | Skrypty w tym samym łańcuchu współdzielą globalThis — przekazuj wartości przez globalThis.xxx |
| AES „szyfrowanie nie powiodło się” w skryptach | Zły kształt argumentów | $crypto.encryptAES przyjmuje pozycyjne stringi, nie obiekt {text,key,iv} |
Skrypt kończy się błędem require: 未找到库 [...] | Zły klucz biblioteki albo biblioteka skryptów użytkownika została przemianowana/usunięta | Skopiuj instrukcję require z menedżera bibliotek (forma z identyfikatorem przeżywa przemianowania); wbudowane klucze to @libs/base64 / @libs/hex; require w komentarzach jest ignorowany i nigdy nie jest dołączany |
Ściąga rozwiązywania zmiennych
{{name}}: rozwiązuje tylko zmienne konfiguracji środowiska / zmienne na pojedynczą wysyłkę; nie potrafi odczytać wartości zapisanych w runtime przez skrypty.- Odczyt zmiennych w skryptach: wszystkie trzy warstwy są czytelne — używaj tego do przekazywania tokenów między żądaniami.
- Aby wyekstrahowane wartości były też dostępne dla
{{}}: włącz ustawienie „zapis ekstrakcji z powrotem do środowiska”.
Szczegóły: concepts, system zmiennych.
Nadal utknąłeś?
- Najpierw uruchom „minimalny działający przypadek” z
/echo(HTTP) albo/ws/echo(WS), potem dodawaj autoryzację/skrypty krok po kroku. - Debuguj po jednym kroku: czy żądanie w ogóle wychodzi (nie łączy → sprawdź Pre-URL/host/port) → czy skrypty się wykonują (czy wykonywanie skryptów włączone) → czy zmienne się rozwiązują (która warstwa)?
- Błędy związane ze skryptami możesz zestawić z Dokumentacją API skryptów.