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ı
| Belirti | Olası neden | Çözüm |
|---|---|---|
| "No base address" bildiriliyor | Gruba ortam bağlı değil ya da ortamda o protokolün Pre-URL'si yok | Ortam bağlayın, protokolün Pre-URL'sini ekleyin |
| WS/gRPC/MQTT bağlanmıyor | Pre-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ıyor | Host 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üşüyor | Boştayken otomatik geri kazanılıyor | Kullanmadan ö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)
| Belirti | Neden | Çözüm |
|---|---|---|
| Token olmasına rağmen 401 | Gö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ı okuyamaz | sdk.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
| Belirti | Neden | Çözüm |
|---|---|---|
| Yanıtta bozuk Çince metin | Sunucu 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üyor | Geç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 bildiriyor | Script'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
| Belirti | Neden | Çözüm |
|---|---|---|
| Gönderim öncesi script body'yi değiştirdi ama hat üzerinde görünmüyor | "Atama" ile yeniden yazma yok | request.body = new string (atama tüm body'nin yerini alır) |
| Yanıt sonrası yeniden yazma görünmüyor | Nasıl yazılır | response.body = new string; UI/sonuç görünümü yeniden yazmadan sonra yeni içeriği gösterir |
| Script "giriş noktası yok, atlandı" bildirildi | Yanlış fonksiyon adı | Tam olarak onRequest / onResponse adlandırılmalı |
| Script'ler birbirinin değerlerini okuyamıyor | Paylaşım mekanizması bilinmiyor | Aynı 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ız | Kütüphane anahtarı yanlış ya da kullanıcı script kütüphanesi yeniden adlandırıldı/silindi | Require 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.