Pemecahan Masalah (FAQ)
Disusun sebagai "gejala → penyebab → solusi". Kegagalan koneksi, kegagalan autentikasi, teks kacau, dan variabel yang tidak terurai adalah empat kategori besar.
Kegagalan Koneksi / Pengiriman
| Gejala | Penyebab yang mungkin | Solusi |
|---|---|---|
| Dilaporkan "No base address" | Grup tidak memiliki lingkungan terikat, atau lingkungan tidak memiliki Pre-URL untuk protokol tersebut | Ikatkan lingkungan, tambahkan Pre-URL protokol tersebut |
| WS/gRPC/MQTT tidak mau terhubung | Skema Pre-URL salah (protokol diklasifikasikan berdasarkan skema) | ws memakai ws/wss, grpc memakai grpc/grpcs, mqtt memakai mqtt/mqtts |
| TCP/UDP tidak mau terhubung | Host dan port tertukar | Host berisi alamat, port terpisah |
| Kesalahan TLS | Skema terenkripsi tetapi tidak ada sertifikat yang dikonfigurasi | Impor sertifikat klien, atau matikan verifikasi TLS sesuai kebutuhan |
| Koneksi panjang putus mendadak | Direklamasi otomatis saat menganggur | Sambungkan ulang sebelum digunakan; tutup sesi lama segera saat debugging secara batch (kuota terbatas) |
Autentikasi (401 / 403)
| Gejala | Penyebab | Solusi |
|---|---|---|
| 401 meski ada token | Skrip pra-kirim tidak berjalan (eksekusi skrip dinonaktifkan) | Pastikan "execute scripts" aktif |
{{authToken}} tetap literal (tidak diganti) | {{}} tidak bisa membaca token yang disimpan di runtime | Gunakan skrip pra-kirim dengan sdk.env.get untuk menyuntikkan header (lihat resep, skenario 1) |
| Permintaan berikutnya tidak mendapat token setelah login | Kedua permintaan berada di grup / lingkungan berbeda | Letakkan keduanya di grup yang sama yang terikat ke lingkungan yang sama (variabel runtime bersifat per lingkungan) |
Teks Kacau / Encoding
| Gejala | Penyebab | Solusi |
|---|---|---|
| Teks Mandarin kacau di respons | Server mengembalikan non-UTF-8 (mis. GBK) | Dekode dengan charset yang sesuai; reproduksi lewat /charset/gbk |
Dekripsi mengembalikan string Error: ... | Ciphertext tidak valid/kosong, atau key/iv berbeda dari enkripsi (kegagalan $crypto hanya mengembalikan string error, tidak pernah throw/abort) | Pastikan key & iv enkripsi/dekripsi identik; periksa apakah string yang dikembalikan diawali Error: (plaintext Mandarin round-trip dengan baik, terverifikasi) |
Skrip melaporkan Script aborted request | Pengecualian JS yang tidak tertangkap di skrip (umum: nilai header non-ASCII di headers.set, atau akses properti pada undefined) | Bungkus panggilan berisiko dalam try/catch; letakkan konten UTF-8 di body/query params dan jaga nilai header tetap ASCII |
| Hasil base64 aneh di skrip | Meneruskan Uint8Array/bytes ke $codec/sdk.utils (di-String()-kan menjadi "97,98,99" sebelum dienkode) | Selalu teruskan string; $codec.base64Encode/Decode maupun sdk.utils.base64Encode/Decode adalah string↔string yang UTF-8-aware — pilih salah satu |
Skrip Tidak Berfungsi
| Gejala | Penyebab | Solusi |
|---|---|---|
| Skrip pra-kirim mengubah body tetapi tidak terlihat di kawat | Tidak ada penulisan ulang berupa "penugasan" | request.body = new string (penugasan menggantikan seluruh body) |
| Penulisan ulang pasca-respons tidak terlihat | Cara menulis ulang | response.body = new string; tampilan UI/hasil menunjukkan konten baru setelah penulisan ulang |
| Skrip dilaporkan "no entry point, skipped" | Nama fungsi salah | Harus bernama onRequest / onResponse |
| Skrip tidak bisa membaca nilai satu sama lain | Tidak familiar dengan mekanisme berbagi | Skrip dalam rantai yang sama berbagi globalThis — teruskan nilai via globalThis.xxx |
| AES "encryption failed" di skrip | Bentuk argumen salah | $crypto.encryptAES menerima string posisi, bukan objek {text,key,iv} |
Skrip gagal dengan require: 未找到库 [...] | Key pustaka salah, atau pustaka skrip pengguna diubah nama/dihapus | Salin pernyataan require dari pengelola pustaka (bentuk identifier bertahan saat penggantian nama); key bawaan adalah @libs/base64 / @libs/hex; require di dalam komentar diabaikan dan tidak pernah di-bundle |
Lembar Contekan Resolusi Variabel
{{name}}: hanya menyelesaikan variabel konfigurasi lingkungan / variabel per-pengiriman; tidak bisa membaca nilai yang disimpan saat runtime oleh skrip.- Membaca variabel di dalam skrip: ketiga lapis dapat dibaca — gunakan ini untuk penerusan token lintas permintaan.
- Agar nilai hasil ekstraksi juga dapat dipakai
{{}}: aktifkan pengaturan "write extraction back to environment".
Detail: konsep, sistem variabel.
Masih Tersangkut?
- Dapatkan "kasus kerja minimal" berjalan lebih dulu dengan
/echo(HTTP) atau/ws/echo(WS), lalu tambahkan auth/skrip langkah demi langkah. - Debug satu langkah dalam satu waktu: apakah permintaan bisa keluar sama sekali (tidak bisa terhubung → periksa Pre-URL/host/port) → apakah skrip dieksekusi (apakah eksekusi skrip aktif) → apakah variabel terurai (di lapis mana)?
- Kesalahan terkait skrip dapat dicocokkan dengan Referensi Script API.