Przejdź do głównej zawartości

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​

ObjawPrawdopodobna przyczynaRozwiązanie
Komunikat „No base address”Grupa nie ma powiązanego środowiska albo środowisku brakuje Pre-URL tego protokołuPowiąż ś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 portHost przechowuje adres, port jest osobno
Błędy TLSSchemat szyfrowany, ale brak skonfigurowanego certyfikatuZaimportuj certyfikat klienta albo wyłącz weryfikację TLS w razie potrzeby
Długotrwałe połączenie nagle znikaOdzyskiwane automatycznie przy bezczynnościPołącz się ponownie przed użyciem; zamykaj stare sesje od razu przy debugowaniu partiami (limit jest ograniczony)

Autoryzacja (401 / 403)​

ObjawPrzyczynaRozwiązanie
401 nawet z tokenemSkrypt 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 runtimeUżyj skryptu przed wysłaniem z sdk.env.get, żeby wstrzyknąć nagłówek (zobacz recipes, scenariusz 1)
Następne żądanie nie dostaje tokena po logowaniuOba żądania są w różnych grupach / środowiskachUmieść je w tej samej grupie powiązanej z tym samym środowiskiem (zmienne uruchomieniowe mają zasięg per środowisko)

Nieczytelne znaki / kodowanie​

ObjawPrzyczynaRozwiązanie
Nieczytelne znaki chińskie w odpowiedziSerwer 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 requestNieprzechwycony 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 skryptachPrzekazano 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ą​

ObjawPrzyczynaRozwią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 niewidoczneJak 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 funkcjiMusi nazywać się dokładnie onRequest / onResponse
Skrypty nie mogą czytać wartości nawzajemNieznajomość mechanizmu współdzieleniaSkrypty w tym samym łańcuchu współdzielą globalThis — przekazuj wartości przez globalThis.xxx
AES „szyfrowanie nie powiodło się” w skryptachZł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ętaSkopiuj 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.