Lewati ke konten utama

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​

GejalaPenyebab yang mungkinSolusi
Dilaporkan "No base address"Grup tidak memiliki lingkungan terikat, atau lingkungan tidak memiliki Pre-URL untuk protokol tersebutIkatkan lingkungan, tambahkan Pre-URL protokol tersebut
WS/gRPC/MQTT tidak mau terhubungSkema Pre-URL salah (protokol diklasifikasikan berdasarkan skema)ws memakai ws/wss, grpc memakai grpc/grpcs, mqtt memakai mqtt/mqtts
TCP/UDP tidak mau terhubungHost dan port tertukarHost berisi alamat, port terpisah
Kesalahan TLSSkema terenkripsi tetapi tidak ada sertifikat yang dikonfigurasiImpor sertifikat klien, atau matikan verifikasi TLS sesuai kebutuhan
Koneksi panjang putus mendadakDireklamasi otomatis saat menganggurSambungkan ulang sebelum digunakan; tutup sesi lama segera saat debugging secara batch (kuota terbatas)

Autentikasi (401 / 403)​

GejalaPenyebabSolusi
401 meski ada tokenSkrip pra-kirim tidak berjalan (eksekusi skrip dinonaktifkan)Pastikan "execute scripts" aktif
{{authToken}} tetap literal (tidak diganti){{}} tidak bisa membaca token yang disimpan di runtimeGunakan skrip pra-kirim dengan sdk.env.get untuk menyuntikkan header (lihat resep, skenario 1)
Permintaan berikutnya tidak mendapat token setelah loginKedua permintaan berada di grup / lingkungan berbedaLetakkan keduanya di grup yang sama yang terikat ke lingkungan yang sama (variabel runtime bersifat per lingkungan)

Teks Kacau / Encoding​

GejalaPenyebabSolusi
Teks Mandarin kacau di responsServer 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 requestPengecualian 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 skripMeneruskan 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​

GejalaPenyebabSolusi
Skrip pra-kirim mengubah body tetapi tidak terlihat di kawatTidak ada penulisan ulang berupa "penugasan"request.body = new string (penugasan menggantikan seluruh body)
Penulisan ulang pasca-respons tidak terlihatCara menulis ulangresponse.body = new string; tampilan UI/hasil menunjukkan konten baru setelah penulisan ulang
Skrip dilaporkan "no entry point, skipped"Nama fungsi salahHarus bernama onRequest / onResponse
Skrip tidak bisa membaca nilai satu sama lainTidak familiar dengan mekanisme berbagiSkrip dalam rantai yang sama berbagi globalThis — teruskan nilai via globalThis.xxx
AES "encryption failed" di skripBentuk 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/dihapusSalin 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.