Ana içeriğe geç

Sorun Giderme (SSS)

"Belirti → neden → çözüm" düzeninde. Bağlantı hataları, kimlik doğrulama hataları, bozuk metin ve çözülemeyen değişkenler dört büyük kategoridir.

Bağlantı / Gönderim Hataları​

BelirtiOlası nedenÇözüm
"No base address" bildiriliyorGruba ortam bağlı değil ya da ortamda o protokolün Pre-URL'si yokOrtam bağlayın, protokolün Pre-URL'sini ekleyin
WS/gRPC/MQTT bağlanmıyorPre-URL şeması yanlış (protokol şemaya göre sınıflandırılır)ws ws/wss, grpc grpc/grpcs, mqtt mqtt/mqtts kullanır
TCP/UDP bağlanmıyorHost ve port yer değiştirmişHost adresi alır, port ayrıdır
TLS hatalarıŞifreli şema ama sertifika yapılandırılmamışGerekirse istemci sertifikası içe aktarın ya da TLS doğrulamasını kapatın
Uzun bağlantı aniden düşüyorBoştayken otomatik geri kazanılıyorKullanmadan önce yeniden bağlanın; toplu hata ayıklamada eski oturumları hemen kapatın (kota sınırlıdır)

Kimlik Doğrulama (401 / 403)​

BelirtiNedenÇözüm
Token olmasına rağmen 401Gönderim öncesi script çalışmadı (script çalıştırma kapalı)"Script çalıştırma" açık mı kontrol edin
{{authToken}} düz metin kalıyor (değişmiyor){{}} çalışma zamanında saklanan token'ları okuyamazsdk.env.get ile header enjekte eden bir gönderim öncesi script kullanın (bkz. recipes, senaryo 1)
Sonraki istek login'den sonra token'ı alamıyorİki istek farklı grup / ortamlardaİkisini aynı ortama bağlı aynı gruba koyun (çalışma zamanı değişkenleri ortam başına kapsamlanır)

Bozuk Metin / Kodlama​

BelirtiNedenÇözüm
Yanıtta bozuk Çince metinSunucu UTF-8 dışı döndürüyor (ör. GBK)Eşleşen charset ile kod çözün; /charset/gbk ile yeniden üretin
Şifre çözme Error: ... dizesi döndürüyorGeçersiz/boş ciphertext ya da key/iv şifrelemeden farklı ($crypto hataları yalnızca hata dizesi döndürür, asla fırlatmaz/durdurmaz)Şifreleme/çözme key ve iv'sini aynı tutun; dönen dizenin Error: ile başlayıp başlamadığını kontrol edin (Çince düz metin problemsiz round-trip yapar, doğrulandı)
Script Script aborted request bildiriyorScript'te yakalanmamış JS istisnası (sık: headers.set içinde ASCII dışı header değerleri ya da undefined üzerinde özellik erişimi)Riskli çağrıları try/catch ile sarın; UTF-8 içeriği body/query parametrelerine koyun ve header değerlerini ASCII tutun
Script'lerde tuhaf base64 sonucu$codec/sdk.utils'a Uint8Array/byte geçirildi (kodlamadan önce String() ile "97,98,99" olur)Her zaman dize geçirin; $codec.base64Encode/Decode ve sdk.utils.base64Encode/Decode her ikisi de UTF-8 farkında dize↔dizedir — birini seçin

Script'ler Etkisiz​

BelirtiNedenÇözüm
Gönderim öncesi script body'yi değiştirdi ama hat üzerinde görünmüyor"Atama" ile yeniden yazma yokrequest.body = new string (atama tüm body'nin yerini alır)
Yanıt sonrası yeniden yazma görünmüyorNasıl yazılırresponse.body = new string; UI/sonuç görünümü yeniden yazmadan sonra yeni içeriği gösterir
Script "giriş noktası yok, atlandı" bildirildiYanlış fonksiyon adıTam olarak onRequest / onResponse adlandırılmalı
Script'ler birbirinin değerlerini okuyamıyorPaylaşım mekanizması bilinmiyorAynı zincirdeki script'ler globalThis paylaşır — değerleri globalThis.xxx ile aktarın
Script'lerde AES "şifreleme başarısız"Yanlış argüman biçimi$crypto.encryptAES konumsal dizeler alır, {text,key,iv} nesnesi değil
Script require: 未找到库 [...] ile başarısızKütüphane anahtarı yanlış ya da kullanıcı script kütüphanesi yeniden adlandırıldı/silindiRequire ifadesini kütüphane yöneticisinden kopyalayın (tanımlayıcı biçimi yeniden adlandırmalardan etkilenmez); yerleşik anahtarlar @libs/base64 / @libs/hex; yorumlardaki require yok sayılır ve hiçbir zaman paketlenmez

Değişken Çözümü Kopy Kâğıdı​

  • {{name}}: yalnızca ortam yapılandırma değişkenlerini / gönderim başına değişkenleri çözer; script'lerin çalışma zamanında sakladığı değerleri okuyamaz.
  • Script'lerin içinde değişken okuma: üç katman da okunabilir — istekler arası token aktarımı için bunu kullanın.
  • Ayıklanan değerlerin {{}} tarafından da kullanılabilmesi için: "ayıklamayı ortama geri yaz" ayarını etkinleştirin.

Ayrıntılar: concepts, değişken sistemi.

Hâlâ Takıldınız mı?​

  • Önce "minimal çalışan örnek"i /echo (HTTP) ya da /ws/echo (WS) ile çalıştırın, sonra auth/script'leri adım adım ekleyin.
  • Tek seferde bir adım hata ayıklayın: istek hiç çıkıyor mu (bağlanamıyor → Pre-URL/host/port kontrol edin) → script'ler çalışıyor mu (script çalıştırma açık mı) → değişkenler çözülüyor mu (hangi katman)?
  • Script ile ilgili hataları Script API Referansı ile çapraz kontrol edebilirsiniz.